Developer Portal Home Management
概述
本教程解释了如何管理开发者门户的主页。您将能够设置品牌元素(favicon、logo)、设计促销横幅(幻灯片)、管理页脚链接,并上传自定义样式。这些设置有助于将您的门户与公司身份对齐,并改善开发者体验。
先决条件
您必须具备:
- APIM 控制台 > 管理 > 主页管理的管理员访问权限
- 合适大小的图像资产和 logo 文件
- 页脚信息(URLs、版权)
分步教程
第 1 步. 设置站点信息
Field | Example |
---|---|
站点名称 | SK Developers(如果已配置,则自动填充) |
第 2 步. 上传 Favicon
- 上传一个 1:1 纵横比的正方形图像
- 实际显示大小为 16x16px
示例:
- 文件名:favicon-sk.png
- 尺寸:64x64px
- 文件类型:png
使用简化的公司 logo 或符号以便在小尺寸下可见。
第 3 步. 上传 Logo 图像
- 上传一个宽度自适应且最大高度为 40px 的矩形 logo
- 推荐最大宽度:150px
示例:
- 文件名:logo-skapim-dark.svg
- 类型:svg
- 尺寸:自适应宽度 × 40px 高度
第 4 步. 管理幻灯片图像
- 推荐尺寸:2000px × 550px
- 每个幻灯片可以链接到内部或外部页面
- 您可以重新排序、切换可见性或删除
模拟幻灯片:
Slide | Image | Link | Order | Active |
---|---|---|---|---|
1 | slide-api-intro.jpg | /readme?page=intro | 1 | 已选中 |
2 | slide-openapi.png | /readme?page=docs | 2 | 已选中 |
3 | slide-auth.png | /readme?page=auth | 3 | 已选中 |
4 | slide-api-key.png | /readme?page=apikey | 4 | 未选中 |
5 | slide-monitoring.png | /readme?page=monitoring | 5 | 未检查 |
使用一致的纵横比以避免布局问题。
第5步. 设置幻灯片间隔
选择幻灯片图像更换的频率(1–30秒)
示例:将间隔设置为2秒
第6步. 配置页脚
Footer CopyrightField | Value |
---|---|
文本 | 版权所有 © SKAPIM 保留所有权利 |
您可以添加帮助/联系/条款/自定义链接:
标签 | URL |
---|---|
关于我们 | https://skapim.co.kr/about |
帮助 | https://skapim.co.kr/help |
联系 | https://skapim.co.kr/contact |
条款与条件 | https://skapim.co.kr/terms |
点击X以删除或使用编辑图标进行修改。
第7步. 上传自定义样式文件
您可以上传:
- 用于主题覆盖的CSS文件
- 图像(例如,自定义背景)
- 字体(例如,.ttf,.woff等)
示例文件类型:
- custom-dark.css
- corporate-banner.png
- Roboto-Regular.woff2
接受的格式:css,jpg,jpeg,png,ico,tif,tiff,gif,bmp,raw,eot,ttf,woff,woff2
这允许对开发者门户的外观进行高级自定义。
第8步. 保存所有更改
在所有更改完成后,点击底部的保存按钮。
最佳实践
- 使用压缩和优化的图像以提高加载时间
- 确保所有幻灯片链接指向有效的内部或外部文档
- 在多个设备上预览上传的资产
- 通过自定义CSS保持品牌一致性(色彩调色板,字体)
- 随着门户的发展,保持幻灯片和页脚内容的更新