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. 定义页面布局模板 复制链接链接已复制到粘贴板!
常规的概念是为门户中的每个不同页面风格定义单独的布局。启动时有一个名为"主布局"的标准布局。在使用开发人员门户时,最好不要对此操作进行任何更改,因为这是所有系统生成的页面所使用的。通常,您希望具有门户主页的唯一风格。
主布局模板将是您自定义的起点。创建新布局,并将主布局的内容复制到其中。
通过从 "home layout" 中删除这一行来删除侧边栏菜单:
{% include 'submenu'%}
15.2.4. 创建页面层次结构 复制链接链接已复制到粘贴板!
从站点映射中的根级别开始,并为每个顶部菜单项添加新部分(通过展开右侧的"new"按钮来添加部分)。分配标题、父部分和路径。
与添加部分类似,添加页面。选择所需部分以统一构建您的 URL 路径。接下来,选择页面要使用的布局。完成页面内容后,按"创建页面"。如果要编写大量内容,您可能需要使用类似 Textile 或 Markdown 的语言,您可以在高级页面设置中选择。
查看草案预览并优化页面内容,直到您满意并准备好发布它。
- 对部分中的所有页面重复此操作。
- 然后,对站点中的所有部分重复。
15.2.5. 编辑页面标头 复制链接链接已复制到粘贴板!
所有重复页面元素(如 headers 和 footers)都在名为"partials"门户网站开发人员门户部分中定义。如果您只有一个布局或非常少的布局,您可以省略这一步,并在布局代码中包含标头和页脚。但是,请记住在布局中自定义这些元素。例如,应编辑默认的"子菜单"部分以反映您的站点映射。
15.2.6. 添加镜像和其他资产 复制链接链接已复制到粘贴板!
对于镜像或其他文件,首先将文件加载到内容库中,然后将链接插入到文本内容中。
- 选择 New File 以选择您的文件,并确定您将保存在您的站点的位置。
- 将 URL 复制到镜像
- 现在,您可以添加 HTML 或 <a> 标签,并粘贴到镜像的 URL 中。
15.2.7. 使用您的品牌自定义 复制链接链接已复制到粘贴板!
有一个名为 default.css 的默认样式表,它非常大且复杂。最好根据自己的自定义创建自己的风格表来覆盖默认值,而不是扩展它。
您可以像创建页面一样创建新样式表 - 只需在高级页面设置中选择适当的 MIME 内容类型。然后,在链接到 default.css 后在布局模板中添加到自定义 CSS 的链接,例如:
<link rel="stylesheet" href="/stylesheets/custom.css" />
15.2.8. 进行实时 复制链接链接已复制到粘贴板!
最后的任务是查看整个门户站点并检查所有工作流。您可以在 Changes 部分发布每个页面或所有页面。一旦您对所有内容很满意,请进行最后检查是否已发布所有页面。
现在,您已准备好删除门户的任何访问代码:
祝贺您!您的开发人员门户现已上线,并准备好构建开发人员社区。