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”。