haxe.org

haxe.org

Ini adalah basis kode untuk situs web https://haxe.org.

Berkontribusi konten

Di situs web ada tautan "berkontribusi" di footer setiap halaman. Mengklik tautan ini akan membawa Anda ke file yang relevan di repositori ini, atau file yang relevan di repositori haxemanual.

Anda kemudian dapat mengedit menggunakan editor file online GitHub dan mengirimkan permintaan tarik. Anda juga dapat membayar repo dan mengedit pada mesin lokal Anda dengan editor teks pilihan Anda, yang mungkin lebih mudah untuk integrasi besar.

Menambahkan posting blog

Tambahkan file bernama YEAR-MONTH-DAY-name.md dalam posts/ .

Bagian pertama dari file tersebut berisi metadata posting:

 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 Penulis harus terdaftar di people.json :

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

Gambar latar belakang harus disimpan di www/img/blog/backgrounds/ .

Tag harus terdaftar dalam posts/tags.json :

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

Pos perlu memiliki --- dan garis kosong antara metadata dan konten.

Konten posting sedang dalam penurunan harga, tetapi Anda dapat memasukkan beberapa HTML. Jika Anda melakukannya, itu harus valid XML, jadi semua tag harus ditutup: <br /> tidak apa-apa tapi <br> tidak, dan Anda tidak dapat memiliki atribut nilai-kurang: <tag fullscreen="" /> tidak apa-apa tapi <tag fullscren /> tidak.

Untuk memasukkan gambar dalam Markdown : ![Title](name.png) . Gambar harus disimpan dalam www/img/blog/YEAR-MONTH-DAY-name/ .

Masalah, bug dan saran

Jika Anda menemukan bug, memiliki masalah, saran, atau ingin berkontribusi dengan cara lain, silakan gunakan pelacak masalah GitHub.

Bug apa pun yang akan kami atasi segera. Konten baru atau masalah subyektif (warna, font, materi pemasaran dll) akan dipertimbangkan berdasarkan kasus per kasus.

Jika Anda seorang desainer dan ingin membantu menyegarkan tampilan situs, buka masalah atau hubungi [email protected]. Kami akan menyukai masukan Anda!

Kontribusi CSS

Saat ini CSS untuk situs ini ada di www/css/style.css.

Kami saat ini menggunakan Bootstrap 2.3.2 CSS Library dan Font Awesome 4.1.0 Icon Library.

Struktur

• Konten halaman ada di pages/ , baik dalam html atau penurunan harga.
• Posting blog ada di posts/ dalam penurunan harga, dan gambar mereka ada di www/img/blog/$name/ .
• Pesan rilis untuk versi HAXE berada di releaseNotes/ , dalam Markdown.
• Kode dalam src/ . Generasi memanggil src/Main.hx dan javascript src/Client.hx .
• Tampilan berada dalam views/ dan menggunakan sintaks Template Haxe dengan foreach dinonaktifkan.
• Aset statis ada di www/ .

Menjalankan salinan lokal untuk pengembangan

Situs web Haxe.org dirancang agar mudah dihasilkan, untuk menjalankan salinan lokal mengikuti langkah -langkah ini:

Persyaratan

• Haxe
• Haxelib
• Neko
• keriting
• NodeJS
• NPM

Menyiapkan

• Instal dependensi haxelib install all dan npm install di direktori root.
• Perbarui dependensi submodule git submodule init && git submodule update .
• Kloning manual ke direktori manual dengan git clone https://github.com/HaxeFoundation/HaxeManual.git manual .
• Hasilkan situs web dengan menjalankan haxe generate.hxml .

Situs web ini sekarang tersedia di folder out/ , Anda dapat meluncurkannya dengan nekotools server -d out dan mengaksesnya di http://localhost:2000/ .

Menggunakan pembaruan

• Setiap dorongan atau penggabungan ke cabang staging akan memicu tindakan GitHub untuk membangun dan menggunakan ke "pementasan.haxe.org".
• Setiap dorongan atau penggabungan ke cabang master akan memicu tindakan github untuk membangun dan menggunakan ke "haxe.org".