wiki/CONTRIBUTING.md

4.0 KiB

コントリビュート

コントリビュート方法及びガイドラインです。

commit方法について

Forkしたリポジトリからpull requestを行ってください。

minetest-jpのメンバーであれば直接commitすることも可能です。

Markdownの構文について

基本的には通常のMarkdown構文が使用できます。

ただし、以下のような違いがあります。

  • Markdownの改行はHTMLの改行コード(<br />)に変換されます。
    • GithubのMarkdownと違い、空白行を入れなくても改行可能です。
    • (Github上では正しく表示されない場合があります)

目次の追加

- toc
{:toc}

目次を追加する場合は以上のコードを挿入してください。

ページ更新日について

ページ更新の際はYAML Front Matterにdate(更新日)を書いていただけるとありがたいです。 YAML Front Matterで利用できる独自パラメータについては後述します。

YAML Front Matterで利用できる独自のパラメータについて

date
 
更新日時です。20XX-XX-XXのように記述します。
custom-style
 
追加のCSSです。そのページでのみ使用されるCSSはここに記述します。
custom-head
 
追加のヘッダです。そのページでのみ使用されるscriptタグなどはここに記述します。

Modリスト/ツールリスト/テクスチャパック/サブゲーム/配布マップの追加方法について

_data内にあるページ名と同名のフォルダにymlファイルを追加します。また、スクリーンショットもimages内の同名フォルダに追加します。 ファイル名がソートに使用されます。ファイル名にハイフンは使用できません。

書式は以下のとおりです。

# 名前
name: "Hogehoge Mod"

# 作者名
author: "hogehoger"

# スクリーンショットのパス
# imagesフォルダからのパスを指定します。
screenshot: "/mods-decor/hogehoge.png"

# プラットフォーム名 (ツールのみ使用可能)
platform: "Windows / Linux"

# 説明文
# HTMLコードも使用できます。
description: "hogehogeを追加するMod。"

# 関連リンクリスト
# フォーラムへのリンクやダウンロードリンクなど。
links:
  -
    text: "フォーラム"
    url:  "https://forum.minetest.net"
  -
    text: "ダウンロード"
    url:  "https://github.com/"

# 依存Modリスト (Modのみ使用可能)
depends:
  -
    text: "TU-KA Mod"
    url:  "mods-decor#tu_ka" # もちろんWiki内へのリンクも使用可能です。
  -
    text: "FooBarMod"
    url:  "https://forum.minetest.net"

# 連携可能/対応Modリスト (Modのみ使用可能)
depends_optional:
  -
    text: "Piyopiyo Mod"
    url:  "mods-decor#piyopiyo"
  -
    text: "42"
    url:  "https://forum.minetest.net"

修正の提案、TODOについて

GithubのProjectsにあるTODOリストに追加していただけるとありがたいです。

紹介する動画について

動画紹介に載せる動画は許可を取ったもののみでお願いいたします。