haxe.org
1.0.0
Dies ist die Codebasis für die Website https://haxe.org.
Auf der Website finden Sie einen "Beitrag" -Link auf der Fußzeile jeder Seite. Wenn Sie auf diesen Link klicken, werden Sie in der entsprechenden Datei in diesem Repository oder zur entsprechenden Datei im Haxemanual -Repository übertragen.
Sie können dann mit dem Online -Datei -Editor von Github bearbeiten und eine Pull -Anfrage einreichen. Sie können das Repo auch mit Ihrem bevorzugten Texteditor auf Ihrem lokalen Maschine bearbeiten und für große Integrationen einfacher sein.
Fügen Sie eine Datei mit dem Namen YEAR-MONTH-DAY-name.md in posts/ .
Der erste Teil der Datei enthält die Post -Metadaten:
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
---
Die Autoren -ID sollte in people.json aufgeführt sein:
{
"username" : " the user id used in the post " ,
"name" : " Your Name " ,
"bio" : " One line bio about you "
} Das Hintergrundbild sollte in www/img/blog/backgrounds/ gespeichert werden.
Die Tags sollten in posts/tags.json aufgeführt werden:
{
"tag" : " the tag id " ,
"name" : " the tag display name " ,
"description" : " the tag description, shown on the tag post list "
} Der Beitrag muss die --- und die leere Linie zwischen den Metadaten und dem Inhalt haben.
Der Inhalt eines Beitrags ist in Markdown, aber Sie können einige HTML einfügen. Wenn Sie dies tun müssen, muss XML gültig sein, sodass alle Tags geschlossen werden müssen: <br /> ist in Ordnung, aber <br> ist nicht, und Sie können nicht mehr wertfreie Attribute haben: <tag fullscreen="" /> ist in Ordnung, aber <tag fullscren /> ist es nicht.
Ein Bild in Markdown einbeziehen :  . Das Bild sollte in www/img/blog/YEAR-MONTH-DAY-name/ werden.
Wenn Sie einen Fehler finden, ein Problem, einen Vorschlag haben oder auf andere Weise einen Beitrag leisten möchten, verwenden Sie bitte den GitHub -Problem -Tracker.
Alle Fehler, die wir umgehend ansprechen werden. Neue Inhalte oder subjektive Probleme (Farben, Schriftarten, Marketingmaterial usw.) werden von Fall zu Fall berücksichtigt.
Wenn Sie Designer sind und helfen möchten, das Aussehen der Website zu erfrischen, öffnen Sie bitte ein Problem oder wenden Sie sich an [email protected]. Wir würden Ihre Eingabe lieben!
Derzeit befindet sich das CSS für die Website in www/css/style.css.
Derzeit verwenden wir die Bootstrap 2.3.2 CSS -Bibliothek und die icon -Bibliothek der Schriftart der Schriftart.
pages/ in HTML oder in Markdown.posts/ in Markdown, und ihre Bilder befinden sich in www/img/blog/$name/ .releaseNotes/ in Markdown.src/ . Die Generationen rufen src/Main.hx und das JavaScript src/Client.hx auf.views/ und verwendet die HAXE -Vorlagensyntax mit deaktiviert foreach.www/ . Die HAXE.org -Website wurde so konzipiert, dass sie einfach zu generieren ist, um eine lokale Kopie auszuführen. Folgen Sie folgenden Schritten:
haxelib install all und npm install im Stammverzeichnis.git submodule init && git submodule update .manual Verzeichnis mit git clone https://github.com/HaxeFoundation/HaxeManual.git manual .haxe generate.hxml ausführen. Die Website ist ab sofort im out/ Ordner verfügbar. Sie können sie mit nekotools server -d out starten und unter http://localhost:2000/ zugreifen.
staging -Zweig auslöst GitHub -Aktionen zum Erstellen und Bereitstellen von "staging.haxe.org".master -Zweig löst GitHub -Aktionen aus, um "haxe.org" zu erstellen und bereitzustellen.
