写一篇博文

我们邀请创作共用社区的成员在上面写客座帖子卡塔尔vs葡萄牙分析我们的技术博客

写什么

你可以写任何与CC和技术有交集的东西。一些例子:

  • 一个新的抄送或版权相关的工具
  • 使用CC官方工具或服务
  • 你对CC项目的贡献
  • CC相关技术项目的想法或分析
  • 在cc相关项目的上下文中使用技术的最佳实践指南
  • 你的想法在这里

把你要写的东西浮起来是个好主意和CC技术团队合作这样我们就可以在你投入写作之前给你反馈。

写作技巧

组织关于项目的帖子
如果你正在写一个你正在做的项目,这里有一些方法可以组织你的文章:

  • 谈谈从你第一次开始创建它的过程,以及你必须做出的决定(例如:文章1文章2
  • 谈谈你做过的技术决定和面临的挑战(例如:文章1文章2
  • 宣布你的项目并请求贡献(例如:CC词汇公告
  • 写一个关于你的项目是如何工作的概述,不要叙述太多(例如:这篇关于CC目录的文章

如果你有更多的建议,向此页提交编辑

如何发布

一旦你写了你的帖子,你可以把它发送给我们(Markdown是最容易的,但我们很高兴与其他格式的工作)或直接创建一个pull request为你的帖子详细如下。

把请求应提交creativecommons.github.io-source存储库.CC开源站点是使用静态站点生成器构建的Lektor而且你的博客文章必须遵循以下文档中的特定格式才能正确出现在网站上。例如,请看此提交添加一个帖子

  1. 的子目录中包含每个博客条目内容/博客/条目文件夹中。创建一个新的子目录slugified你的博客标题的版本。
  2. 创建一个名为contents.lr在刚刚创建的子目录中。这个文件将包含您的博客文章内容。
  3. 如果您的文章使用图像或其他文件,请将它们放在与contents.lr文件。
  4. 填写contents.lr格式如下(看到例子后):

    标题:将此文本替换为您博客文章的标题—类别:将此文本替换为类别名称,如下所示。每个类别名称应该在自己的行中,名称不应该包含空格。example-category-name-2——author:用作者的GitHub用户名替换此文本。名称中不应该有空格。——pub_date:用YYYY-MM-DD格式的出版日期替换此文本。——body:用你帖子的内容(减去标题)替换这段文字。该字段接受Markdown进行格式化。如果你要包含图像,你可以使用Markdown图像语法,即![image-title](image-file-name.jpg)。您不需要指定图像的路径,因为您已经将其上传到步骤3中的相同文件夹中。

    阅读更多关于这里减价格式化

  5. 为你分配给你的帖子的任何新类别创建分类页面。目录中每个类别都有自己的子目录内容/博客/类别目录中。
    • 创建一个使用确切的类别名称就像博客贴着自己的一样contents.lr文件内。
    • contents.lr内的文件应遵循与其他类别相同的格式。这里有一个示例类别内容文件
  6. 同样,如果这是您的第一篇文章,则需要创建一个包含作者信息的文件。目录中的每个作者都有一个子目录内容/博客/作者目录中。
    • 您的作者文件夹必须有的用户名作为作者领域的博客文章和有contents.lr文件内。
    • 用户名字段contents.lrFile也应该使用完全相同的用户名。
    • 作者的contents.lr其中的文件应遵循与其他作者相同的格式。这里有一个示例作者内容文件
  7. 如果您的博客是连接系列的一部分,您需要创建一个包含系列信息的文件。的子目录中每个系列都有一个子目录内容/博客/系列目录中。
    • 创建一个使用确切的系列名称就像博客贴着自己的一样contents.lr文件内。
    • contents.lr内的文件应遵循与其他系列相同的格式。这里有一个示例系列内容文件
  8. 构建creativecommons.github.io-source本地项目(说明在自述在存储库中),并确保您的博客文章在本地正确显示。如果您没有创建适当的类别或作者文件,您将在此步骤中看到一个构建错误。
  9. 推送代码并发出pull请求。
  10. 等待CC的全职工作人员的成员合并到主要分支。

合并后,您的新帖子将自动推送到生产站点,包含您的帖子URL的通知将被发送到# cc-developers通道在松弛。