关于搜索引擎优化 (SEO)
搜索引擎优化 (SEO) 是一种提升网络内容在搜索引擎结果(例如 Google 和 Bing)中可见度的实践。Google 搜索是 GitHub 文档的主要推荐来源,也是用户最常用的入口点。
我们可以规划和撰写内容来改进 SEO。更好的 SEO 会改善人们搜索文档的体验,因为它会提高他们使用首选搜索词找到所需信息的可能性。
内容 SEO 最佳实践
良好的 SEO 需要针对特定受众规划内容,并注意他们用来搜索的词语。请遵循以下最佳实践来改进文章的 SEO。
选择目标受众
了解并针对内容的特定受众(开发人员、管理员或代码学习者)进行写作。这有助于您:
- 使用读者常用的词语。
- 使内容与他们的需求和任务相关。
- 提供适量的上下文和背景信息。
响应搜索意图
围绕**搜索意图**创建内容:推动目标受众在线搜索信息的任务、问题或难题。
- 进行搜索意图研究。例如,分析相关查询的搜索引擎结果页面 (SERP)。
- 了解用户需求。使用多种来源,例如客户反馈、用户访谈和指标。
使用清晰的语言
遵循“GitHub 文档最佳实践”中的指南,包括:
- 确保每篇文章都有一个清晰、独立的主题。
- 将优先级较高的内容放在文章的前面。
- 使用清晰的标题来组织文章。
- 按照“样式指南”编辑内容以确保一致性。
融入关键词
将关键词(或受众使用的主要搜索词)融入页面文本和元数据中。例如,如果您正在撰写有关“账单”的内容,但您的受众主要使用“成本”和“付款”,请使用这些词语。
Google 和 Bing 都提供关键词研究工具,以帮助您发现相关的关键词。文档团队还会参考 Google Search Console 数据,以了解哪些搜索词会导致 GitHub 文档中的页面。
包含元数据
在frontmatter中使用完整的元数据。要查看可用的值,请参阅“使用 YAML 前置信息”。
在 GitHub 文档中,intro
元素显示为页面内的副标题,并用作 HTML 元数据描述。文章标题用作 HTML 页面标题。为了获得良好的 SEO:
- 撰写互补且包含关键词的标题和
intro
。考虑它们在搜索中将如何呈现。 - 为所有图片添加包含关键词的 alt 文本,这也是搜索引擎使用的元数据。请参阅 GitHub 文档样式指南中的“Alt 文本”。
策略性地链接
遵循 GitHub 文档样式指南中的“链接”,谨慎地链接到 GitHub 文档上的其他与任务相关的页面和高质量的同行网站。
通过仔细维护重定向来确保传入链接不会中断。
保持准确性
确保内容在事实、拼写和样式上没有错误。定期审核内容以删除错误(例如断开的链接)并停用不需要的内容。请参阅“配置重定向”。