1.6. 为 3scale 管理的 API 自定义原生开发人员门户的注意事项

在开始自定义原生开发人员门户以创建自己的开发人员门户前，您应该为基本元素、可重复使用的内容、页层次结构、页标题和品牌以及品牌制定计划。

  • 基本开发人员门户元素 - 开发人员门户的计划应该包括：

    • 站点地图：部分您的门户组织方式。
    • 顶部菜单栏中：每个页面上重复的导航。
    • 侧边菜单栏：访问每个部分中的单个页面。
    • 页面布局指南：对于一致的外观和感觉。
    • 可重复利用的内容 - 布局和部分确保开发人员门户网站的一致性。在开始创建页面前创建它们。

  • 页面层次结构 - 从您的站点映射中的根级别开始，为每个顶部菜单项创建一个部分。

    接下来，创建每个顶部菜单项所需的页面。当您创建页面时，请确保将其与正确的部分相关联。这会在 Developer Portal 中为 URL 路径创建一致的结构。要使用标记语言（如 Textile 或 Markdown）对页面进行编码，请展开页面 ADVANCED OPTIONS。Handler 字段标识标记语言。

  • 页面标头和页脚 - 通常会在部分定义页面元素。当您只有几个布局时，您可能需要直接在布局中定义标头和页脚。

  • 品牌 - 默认原生开发人员门户风格表 default.css 非常复杂。使用自定义（覆盖默认值）创建您自己的风格表，而不是扩展此样式表。

    您可以像创建页面一样创建新的风格表。在高级页面设置中选择 css 部分和适当的 MIME 内容类型。然后，在您的布局中，链接到 default.css 后，向您的自定义风格表添加一个链接。例如，如果您创建 my-custom.css，您可以插入： 

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

  • 您无法修改的内置功能包括：

    • 分页
    • 消息菜单
    • 论坛 - 您只能更改布局。
    • 支付 - 这些页面中只有几个文本字段可编辑。