haxe.org

haxe.org

这是https://haxe.org网站的代码库。

贡献内容

在网站上，每个页面的页脚都有一个“贡献”链接。单击此链接将带您到此存储库中的相关文件或Haxemanual存储库中的相关文件。

然后，您可以使用GitHub的在线文件编辑器进行编辑，并提交拉动请求。您还可以使用首选的文本编辑器在本地计算机上进行编辑，这对于大型集成可能会更容易。

添加博客文章

在posts/中添加一个名为YEAR-MONTH-DAY-name.md的文件。

文件的第一部分包含元数据：

 title : The title of your post
author : Author id
description : The description of your post
background : Optional image filename used as background for the post header
published : true/false, if true it'll apear in the blog post list/rss feed
tags : Comma separated of tags id
disqusID : Unique id number used for comments, take the number of the last post and increment it by one
---

作者身份证应在people.json中列出：JSON：

{
  "username" : " the user id used in the post " ,
  "name" : " Your Name " ,
  "bio" : " One line bio about you "
}

背景图像应存储在www/img/blog/backgrounds/中。

标签应在posts/tags.json中列出：json：

{
  "tag" : " the tag id " ,
  "name" : " the tag display name " ,
  "description" : " the tag description, shown on the tag post list "
}

该帖子需要具有---数据和内容之间的空白线。

帖子的内容在Markdown中，但您可以包括一些HTML。如果您这样做需要有效XML，因此所有标签都需要关闭： <br />还可以，但是<br>不是，并且您不能拥有无价值的属性： <tag fullscreen="" />是可以的，但是<tag fullscren />不。

要在Markdown中包含图像： ![Title](name.png) 。该图像应存储在www/img/blog/YEAR-MONTH-DAY-name/中。

问题，错误和建议

如果您找到一个错误，有问题，建议或想以其他方式贡献，请使用GitHub Disears Tracker。

我们将尝试及时解决的任何错误。新内容或主观问题（颜色，字体，营销材料等）将在情况下考虑。

如果您是设计师，并且想帮助新的网站外观，请打开问题或[email protected]。我们希望您的投入！

贡献CSS

目前，该网站的CSS以www/css/style.css为单位。

目前，我们使用Bootstrap 2.3.2 CSS库和字体很棒的4.1.0图标库。

结构

• 页面内容以HTML或Markdown为pages/ 。
• 博客帖子在posts/ Markdown中，其图像在www/img/blog/$name/中。
• HAXE版本的发布消息在releaseNotes/中，在Markdown中。
• 该代码在src/中。这些世代调用src/Main.hx和javascript src/Client.hx 。
• 视图在views/ ，并使用for for disabled使用HAXE模板语法。
• 静态资产在www/ 。

运行本地副本进行开发

haxe.org网站旨在易于生成，可以运行本地副本，请按照以下步骤进行操作：

要求

• 哈克斯
• haxelib
• Neko
• 卷曲
• nodejs
• NPM

设置

• 安装依赖项haxelib install all并在根目录中npm install 。
• 更新subpodule依赖项git submodule init && git submodule update 。
• 用git clone https://github.com/HaxeFoundation/HaxeManual.git manual manual手册目录。
• 通过运行haxe generate.hxml生成网站。

该网站现在可以在out/文件夹中提供，您可以使用nekotools server -d out启动它，并在http://localhost:2000/ 。

部署更新

• 任何推送或合并到staging分支机构都将触发github动作以构建和部署到“ staging.haxe.org”。
• 任何推送或合并到master分支机构都将触发github动作以构建和部署到“ haxe.org”。