65.9K
CodeProject 正在变化。 阅读更多。
Home

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

starIconstarIconstarIconstarIcon
emptyStarIcon
starIcon

4.97/5 (53投票s)

2010年3月8日

CPOL

9分钟阅读

viewsIcon

768254

这是我们文章 FAQ 系列的第二篇文章。在本文中,我们将重点介绍文章在 CodeProject 上的发布流程:标题、描述、标签和分类法。

目录

CodeProject 文章

  1. 如何提交文章?

    您可以通过以下三种方式之一提交文章和代码:

    1. 您可以使用我们的 提交向导自行提交文章。
    2. 通过我们的 submit@codeproject.com 地址。只需下载 提交模板文件,撰写您的文章,收集您的图片和下载文件,将所有内容压缩到一个文件中并发送给我们,剩下的事情我们将为您处理。
  2. 为什么要通过 CodeProject 编辑器提交文章?
    优点
    • 文章的语法、拼写和标点符号得到检查
    • 文章格式符合 CodeProject 指南
    • 提高了可读性
    • 作者更轻松,无需处理或使用提交工具,也无需处理 HTML
    缺点
    • 文章处理时间通常为 1-2 个工作日

  3. 为什么要通过提交向导提交?
    优点
    • 立即提交
    缺点
    • 可能不符合 CodeProject 格式和提交指南 - 请仔细格式化!
    • 可读性和可访问性可能较差
    • 需要自己处理 HTML 和向导

  4. 在哪里提交文章?

    从主页,这里


  5. 如何选择文章的版块?

    您可能已经注意到,我们更改了分类法。文章的位置不再由“章节 > 版块 > 子章节”决定,而是由标签决定。

    您可以在发布或更新文章时添加标签。

    目前我们有一系列分类法主题:人工智能、物联网、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、Blazor

    C# 是一个语言标签,属于“编程语言”主题,而 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

  6. 文章的 URL 是如何确定的?

    您文章的 URL 将取决于您为它指定的标题。例如,如果您的标题是“coolcode”,那么您文章的 URL 将是“https://codeproject.org.cn/Articles/ArticleID/coolcode”。

    这个名称很重要,因为它有助于搜索引擎找到您的文章。请确保您给它一个合适的名字。

  7. 描述中应该包含什么内容?

    300 个字符以内(包括空格),描述您文章的目的。做到清晰、简洁;这将决定是否有人阅读您的文章。

  8. 如何使用标签和位置?

    只需开始在“标签”字段中键入。当您键入时,将显示当前标签的下拉列表。相应地进行选择。

    另请注意次要下拉列表,您可以在其中滚动浏览适用的语言、平台、技术和受众列表。

    ArticleFAQ/ParentAttributes.png 注意:某些属性是父属性。如果您选择 C++,如所示,您实际上是选择了所有子级:VC6、VC7、VC7.1、VC8.0 和 VC9.0。

    如果您使用下拉列表选择属性,请勿选中父属性,除非所有子属性都适用。

  9. 应该选择哪些标签?

    为您的文章选择标签时,不仅要选择适用于您文章的标签,还要考虑 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 标签要好得多。

  10. 应该使用什么许可证?

    我们有一个 许可证列表 来帮助您选择适合您和您的代码的许可证。

提示

  1. 什么是提示?

    “技巧与窍门”帖子是针对单个问题,提供单个解决方案,并配有极简的文字说明。理想情况下,您可以在 30 秒内看完。这是一个提示的示例

    Kendo UI NumericTextBox 启用/禁用问题


  2. 如何发布提示?

    从主页,这里

    然后将“发布您的”下拉菜单更改为“提示/窍门”,然后单击“开始编写”按钮。从这里开始,所有内容都与提交文章相同。

参考

  1. 什么是参考?

    参考文章是一种简短(通常为 1 页)的文章,用于查找常见信息,如表格(例如 ASCII 表、HTTP 状态码等)或函数或类的说明。通常很少有图片,也没有可下载的代码(尽管作者可以自行决定)。


  2. 如何发布参考?

    从主页,这里

    然后将“发布您的”下拉菜单更改为“参考”,然后单击“开始编写”按钮。从这里开始,所有内容都与提交文章相同。

项目

  1. 什么是项目?

    您有一个在 GitHub 上文档齐全的仓库,想将其导入为 CodeProject 的文章吗?您需要做的就是确保在主分支的根目录下有一个 Readme.md 文件,剩下的我们来处理。

    所有导入的 GitHub 项目都必须符合与其他文章相同的标准和社区审核系统。它们必须是完整的文章,教授一个概念或提供一个可用的代码片段。代码库的快照将存储在 CodeProject 的本地,并且每次您将更改推送到 GitHub 时,CodeProject 的版本都会自动更新为您最新的更改。您对导入的 CodeProject 版本文章所做的编辑不会推回 GitHub,因此请谨慎操作。


  2. 如何分享我的 GitHub 项目?

    从主页,这里

    然后单击 GitHub 图标以 连接到 GitHub。从这里开始,所有内容都与提交文章相同。

© . All rights reserved.