CodeProject 文章 FAQ - 第二部分:如何在 CodeProject 上发布文章






4.97/5 (53投票s)
这是我们文章 FAQ 系列的第二篇文章。在本文中,我们将重点介绍文章在 CodeProject 上的发布流程:标题、描述、标签和分类法。
目录
CodeProject 文章
- 如何提交文章?
- 为什么要通过 CodeProject 编辑器提交文章?
优点
- 文章的语法、拼写和标点符号得到检查
- 文章格式符合 CodeProject 指南
- 提高了可读性
- 作者更轻松,无需处理或使用提交工具,也无需处理 HTML
缺点
- 文章处理时间通常为 1-2 个工作日
- 为什么要通过提交向导提交?
优点
- 立即提交
缺点
- 可能不符合 CodeProject 格式和提交指南 - 请仔细格式化!
- 可读性和可访问性可能较差
- 需要自己处理 HTML 和向导
- 在哪里提交文章?
从主页,这里
- 如何选择文章的版块?
您可能已经注意到,我们更改了分类法。文章的位置不再由“章节 > 版块 > 子章节”决定,而是由标签决定。
您可以在发布或更新文章时添加标签。
目前我们有一系列分类法主题:人工智能、物联网、DevOps、容器、高性能计算等,其中许多都有相应的分类法父标签,例如 artificial-intelligence、IoT、DevOps、containers 等。然后,在这些之中我们有分类法的子级。例如,artificial-intelligence 有以下分类法子级:big-data、data-science、deep-learning、machine-learning 等。
当一篇文章被创建并打上标签后,它在分类法中的位置将取决于所选的标签。有几个因素会影响此决定,并根据层次结构进行确定。最重要的是分类标签,其次是排序顺序,最后是标签的路径长度。
分类标签
如果您输入的标签是分类标签,或与分类父标签(如 artificial-intelligence、IoT、DevOps、containers 等)相关联,则会得到很大的优先考虑,文章很可能会被归类到相应的“主题”下。例如,文章 / 人工智能
排序顺序
这是我们的分类标签的列出顺序。例如,您可以转到页面顶部的文章下拉列表,将鼠标悬停在“文章”上,然后选择“浏览主题”,这就是分类标签的价值顺序。因此,如果您有一个分类标签 artificial-intelligence 和另一个分类标签 IoT,因为 Artificial Intelligence 在排序顺序中高于 Internet of Things,文章将被归类到 Articles / Artificial Intelligence。
路径长度
我们希望考虑的一个因素是标签路径的长度。标签路径越长越好。例如,如果您输入一个 C#4 标签,它是 C# 的子级,而 C# 是“编程语言”主题的一部分,那么它的路径比一个算法标签要长,算法标签之上只有一个“通用编程”层。因此,C#4 标签的价值更高。
请记住,这是一个不断发展的系统。在文章位置的考虑因素中还有其他因素,例如“主题父项”,如果一个标签无法追溯到分类父项,它将通过主题父项进行查找。
让我们看一个例子。这是
在 Blazor 中构建数据库应用程序 - 第一部分 - 项目结构和框架.
它有以下标签:
C#、ASP.NET、HTML、Markdown、.NET-Core、BlazorC# 是一个语言标签,属于“编程语言”主题,而 ASP.NET、HTML 和 Blazor 是“Web 开发”标签。因为“Web 开发”在主题层次结构中高于“编程语言”,所以它会获得优先权,文章将被归类到 Articles / Web Development / Blazor。如果您查看“Web 开发”主题内的标签列表,您会看到
- Blazor
- CSS3
- flask
- HTML5
- Kestrel
- LESS
- nginx
- Node.js
- React
- SCSS
- Spring
- Vue.js
- ASP.NET
- CSS
- Apache
- HTML
- IIS
- XHTML
请注意 Blazor 位于此列表的顶部。这就是为什么文章被归类到 Blazor,而不是 Articles / Web Development / ASP.NET。 .NET-Core 和 Markdown 不是与任何特定主题相关的子标签,因此在对文章进行分类时,它们会被忽略。
有关主题及其相应子标签的完整列表,请参阅我们的 站点地图。如果您有任何问题、疑虑或主题建议,请随时通过 Bug 和建议论坛与我们联系,或发送电子邮件至 submit@codeproject.com。
- 文章的 URL 是如何确定的?
您文章的 URL 将取决于您为它指定的标题。例如,如果您的标题是“coolcode”,那么您文章的 URL 将是“https://codeproject.org.cn/Articles/ArticleID/coolcode”。
这个名称很重要,因为它有助于搜索引擎找到您的文章。请确保您给它一个合适的名字。
- 描述中应该包含什么内容?
300 个字符以内(包括空格),描述您文章的目的。做到清晰、简洁;这将决定是否有人阅读您的文章。
- 如何使用标签和位置?
只需开始在“标签”字段中键入。当您键入时,将显示当前标签的下拉列表。相应地进行选择。
另请注意次要下拉列表,您可以在其中滚动浏览适用的语言、平台、技术和受众列表。
注意:某些属性是父属性。如果您选择 C++,如所示,您实际上是选择了所有子级:VC6、VC7、VC7.1、VC8.0 和 VC9.0。 如果您使用下拉列表选择属性,请勿选中父属性,除非所有子属性都适用。
- 应该选择哪些标签?
为您的文章选择标签时,不仅要选择适用于您文章的标签,还要考虑 CodeProject 的分类法。如果您的文章在 CodeProject 上更容易找到,那么它更有可能被看到。CodeProject 编辑器只允许您选择八个标签,因此请明智地选择。
首先要考虑的是分类标签。这些是与我们的分类部分相关的标签,例如,人工智能 (artificial-intelligence)、物联网 (IoT)、DevOps、安全 (security)、Web 开发 (web)、移动应用 (mobile)、桌面编程 (desktop)、数据库开发 (database)、生产力应用和服务 (productivity)、游戏开发 (game)、多媒体 (multimedia)。选择这些标签中的一个将大大提高内容在 CodeProject 上的分类方式,并使您的文章更容易找到。
接下来要考虑的是您的主题父标签。这些是嵌套在分类标签中的标签。选择其中一个可以延长您的标签路径,并将您的文章更准确地归类到正确的位置。例如,如果您正在撰写一篇关于人工智能的文章,不要只选择 artificial-intelligence 标签,而是深入挖掘。您的文章是否包含或与深度学习 (deep-learning) 相关?大数据 (big-data)?机器学习 (machine-learning)?也选择这些标签,以便更好地定位文章。
另外,请记住考虑语言标签。有时您可能正在撰写一篇关于某个主题的文章,但该主题不一定有我们主要分类层级中的标签。选择一个语言标签将确保您的文章有一个归宿。
接下来要考虑的是与搜索词相关的标签。我们将标签包含在搜索数据中。此外,Google 在爬取页面时会看到一些标签,但相同的数据可能已经存在于文章文本中,或者应该存在。如果您想在我们的搜索结果中提高某个特定标签的排名,请考虑将其添加到文章中。对于 Google 搜索,在文章正文中也使用该标签很重要。
最后,您想考虑您想选择的标签中有多少个实际存在于 CodeProject 上。您可以查看我们 这里的标签列表 来查看您想包含的标签。选择一个很少使用的标签意味着您的标签不太可能被搜索到,或者无法帮助您的文章获得更多曝光。例如,如果您正在选择最后一个标签,并在 game 标签和 doom 标签之间犹豫不决,那么没有文章或问题带有 doom 标签,所以选择 game 标签要好得多。
- 应该使用什么许可证?
我们有一个 许可证列表 来帮助您选择适合您和您的代码的许可证。
提示
- 什么是提示?
“技巧与窍门”帖子是针对单个问题,提供单个解决方案,并配有极简的文字说明。理想情况下,您可以在 30 秒内看完。这是一个提示的示例
- 如何发布提示?
从主页,这里
然后将“发布您的”下拉菜单更改为“提示/窍门”,然后单击“开始编写”按钮。从这里开始,所有内容都与提交文章相同。
参考
- 什么是参考?
参考文章是一种简短(通常为 1 页)的文章,用于查找常见信息,如表格(例如 ASCII 表、HTTP 状态码等)或函数或类的说明。通常很少有图片,也没有可下载的代码(尽管作者可以自行决定)。
- 如何发布参考?
从主页,这里
然后将“发布您的”下拉菜单更改为“参考”,然后单击“开始编写”按钮。从这里开始,所有内容都与提交文章相同。
项目
- 什么是项目?
您有一个在 GitHub 上文档齐全的仓库,想将其导入为 CodeProject 的文章吗?您需要做的就是确保在主分支的根目录下有一个 Readme.md 文件,剩下的我们来处理。
所有导入的 GitHub 项目都必须符合与其他文章相同的标准和社区审核系统。它们必须是完整的文章,教授一个概念或提供一个可用的代码片段。代码库的快照将存储在 CodeProject 的本地,并且每次您将更改推送到 GitHub 时,CodeProject 的版本都会自动更新为您最新的更改。您对导入的 CodeProject 版本文章所做的编辑不会推回 GitHub,因此请谨慎操作。
- 如何分享我的 GitHub 项目?