15.2. 配置开发人员门户


15.2.1. 规划您的门户概念

从早期阶段,最好规划开发人员门户的概念。您计划中需要考虑最重要的元素包括:

  • 站点映射:门户结构的框架。
  • 顶部菜单栏中:将在每个页面上重复导航。
  • 侧边菜单栏 :要访问每个部分中的各个页面。
  • 页面布局指南 :为门户提供一致的外观和感觉。

15.2.2. 设置编辑环境

编辑环境的最佳设置证明:

  • 显示 使用您的 admin 凭证登录的company-admin.3scale.net/p/admin/cms 选项卡,它提供门户的开发人员门户访问权限
  • 第二个选项卡 指向您的company.3scale.net,门户的公共视图(如果您通过 Site 链接访问此视图,则不必担心访问代码)

在 Admin Panel 中,您可以在左侧栏中看到所有开发人员门户的元素:

开发人员门户主页

15.2.3. 定义页面布局模板

常规的概念是为门户中的每个不同页面风格定义单独的布局。启动时有一个名为"主布局"的标准布局。在使用开发人员门户时,最好不要对此操作进行任何更改,因为这是所有系统生成的页面所使用的。通常,您希望具有门户主页的唯一风格。

  1. 主布局模板将是您自定义的起点。创建新布局,并将主布局的内容复制到其中。

    开发人员门户布局
  2. 通过从 "home layout" 中删除这一行来删除侧边栏菜单:

    {% include 'submenu'%}
    开发人员门户布局编辑

15.2.4. 创建页面层次结构

  1. 从站点映射中的根级别开始,并为每个顶部菜单项添加新部分(通过展开右侧的"new"按钮来添加部分)。分配标题、父部分和路径。

    开发者门户站点映射
  2. 与添加部分类似,添加页面。选择所需部分以统一构建您的 URL 路径。接下来,选择页面要使用的布局。完成页面内容后,按"创建页面"。如果要编写大量内容,您可能需要使用类似 Textile 或 Markdown 的语言,您可以在高级页面设置中选择。

    Developer Portal Sitemap 新页面
  3. 查看草案预览并优化页面内容,直到您满意并准备好发布它。

    开发人员门户发布页面
  4. 对部分中的所有页面重复此操作。
  5. 然后,对站点中的所有部分重复。

15.2.5. 编辑页面标头

所有重复页面元素(如 headers 和 footers)都在名为"partials"门户网站开发人员门户部分中定义。如果您只有一个布局或非常少的布局,您可以省略这一步,并在布局代码中包含标头和页脚。但是,请记住在布局中自定义这些元素。例如,应编辑默认的"子菜单"部分以反映您的站点映射。

开发者门户部分

15.2.6. 添加镜像和其他资产

对于镜像或其他文件,首先将文件加载到内容库中,然后将链接插入到文本内容中。

  1. 选择 New File 以选择您的文件,并确定您将保存在您的站点的位置。
  2. 将 URL 复制到镜像
  3. 现在,您可以添加 HTML 或 <a> 标签,并粘贴到镜像的 URL 中。
开发者门户添加镜像

15.2.7. 使用您的品牌自定义

有一个名为 default.css 的默认样式表,它非常大且复杂。最好根据自己的自定义创建自己的风格表来覆盖默认值,而不是扩展它。

您可以像创建页面一样创建新样式表 - 只需在高级页面设置中选择适当的 MIME 内容类型。然后,在链接到 default.css 后在布局模板中添加到自定义 CSS 的链接,例如:

<link rel="stylesheet" href="/stylesheets/custom.css" />

15.2.8. 进行实时

最后的任务是查看整个门户站点并检查所有工作流。您可以在 Changes 部分发布每个页面或所有页面。一旦您对所有内容很满意,请进行最后检查是否已发布所有页面。

现在,您已准备好删除门户的任何访问代码:

开发者门户访问代码

祝贺您!您的开发人员门户现已上线,并准备好构建开发人员社区。

Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2026 Red Hat
返回顶部