haxe.org

haxe.org

これは、https：//haxe.org Webサイトのコードベースです。

貢献コンテンツ

ウェブサイトには、各ページのフッターに「貢献」リンクがあります。このリンクをクリックすると、このリポジトリの関連ファイル、またはHaxemanualリポジトリの関連ファイルに移動します。

その後、GitHubのオンラインファイルエディターを使用して編集して、プルリクエストを送信できます。また、リポジトリをフォークして、お好みのテキストエディターを使用してローカルマシンで編集することもできます。これは、大規模な統合が簡単かもしれません。

ブログ投稿を追加します

posts/にYEAR-MONTH-DAY-name.mdという名前のファイルを追加します。

ファイルの最初の部分には、POSTメタデータが含まれています。

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

著者IDはpeople.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にリストする必要があります：

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

投稿には、 ---データとコンテンツの間の空白線が必要です。

投稿の内容はマークダウンにありますが、HTMLを含めることができます。実行する場合は有効なXMLである必要があるため、すべてのタグを閉じる必要があります： <br />は大丈夫ですが、 <br>はそうではありません。 <tag fullscreen="" />大丈夫ですが、 <tag fullscren />そうではありません。

マークダウンに画像を含める： ![Title](name.png) 。画像はwww/img/blog/YEAR-MONTH-DAY-name/に保存する必要があります。

問題、バグ、提案

バグを見つけたり、問題を抱えたり、提案したり、他の方法で貢献したりしたい場合は、GitHub Issue Trackerを使用してください。

迅速に対処しようとするバグ。新しいコンテンツまたは主観的な問題（色、フォント、マーケティング資料など）は、ケースバイケースで考慮されます。

あなたがデザイナーであり、サイトの外観をリフレッシュするのを手伝いたい場合は、問題を開くか、[email protected]に連絡してください。私たちはあなたの入力が大好きです！

CSSの寄稿

現在、サイトのCSSはwww/css/style.cssにあります。

現在、Bootstrap 2.3.2 CSSライブラリとFont Awesome 4.1.0アイコンライブラリを使用しています。

構造

• ページコンテンツは、 pages/ 、HTMLまたはマークダウンのいずれかです。
• ブログの投稿はposts/マークダウンにあり、その画像はwww/img/blog/$name/にあります。
• Haxeバージョンのリリースメッセージは、MarkdownのreleaseNotes/にあります。
• コードはsrc/にあります。世代は、 src/Main.hxとJavaScript src/Client.hxを呼び出します。
• ビューはviews/およびforeachが無効になっているHaxeテンプレート構文を使用しています。
• 静的資産はwww/にあります。

開発のためにローカルコピーを実行します

haxe.orgのWebサイトは、生成しやすいように設計されており、ローカルコピーを実行するために、次の手順に従います。

要件

• ハックス
• ハクセリブ
• ネコ
• カール
• nodejs
• npm

セットアップ

• dependencies haxelib install all 、 npm installルートディレクトリにインストールします。
• サブモジュールの依存関係を更新するgit submodule init && git submodule update 。
• git clone https://github.com/HaxeFoundation/HaxeManual.git manualを使用して、 manualディレクトリにマニュアルをクローンします。
• haxe generate.hxmlを実行してWebサイトを生成します。

Webサイトはout/ Folderで利用可能になりました。NekotoolsServer nekotools server -d outで起動してhttp://localhost:2000/でアクセスできます。

更新の展開

• stagingブランチへのプッシュまたはマージは、githubアクションをトリガーして、「staging.haxe.org」に構築および展開します。
• masterブランチへのプッシュまたはマージは、githubアクションをトリガーして「haxe.org」に構築および展開します。