クイックスタートのための例
このページでは、Baseファイルを作成し、変換する最も基本的な方法について説明します。
Step 1. Baseファイルを作成する
foo.base.mdというファイルを作成します。ファイル名は自由に変更しても構いません。
<!---------------------------->
<!-- multilingual suffix: en, fr, ko, ja -->
<!---------------------------->
# Hello, World!
<!-- [en] -->
You can see this written in other languages: `foo.en.md`, `foo.fr.md`, `foo.ja.md`
<!-- [fr] -->
Ceci s'écrit en français comme "Bonjour, le monde !".
<!-- [ko] -->
이것은 한국어로 "안녕, 세상아!"라고 쓴 것입니다.
<!-- [ja] -->
これは日本語で「こんにちは、世のああ！」と書いたものです。
<!-- [common] -->
```md
Thank you for using MMG!
<!-- [en] -->
Tags within code blocks are treated as plain text.
```
ここでは紹介していない機能は、"Baseファイルを作成する"ページを参照してください。
これでMMGを使用する準備が整いました！
次のステップでは、en、fr、ko、jaファイルを作成します。
Step 2. MMGを使用して変換する
変換を実行するには、次のコマンドを実行します。
foo.base.mdと同じパスにfoo.en.md、foo.fr.md、foo.ko.md、foo.ja.mdファイルが作成されていることを確認してください。
注意事項
MMGは、ファイルを作成するときに既存のファイルを上書きします。したがって、Baseファイルを変更しても、作成されたファイルを削除する必要はありません。代わりに、作成されたファイルで行った変更は失われるため、Baseファイルでコンテンツを変更してください。
mmg foo.base.md
例えば、foo.ja.mdの内容は次のようになります。
# Hello, World!
You can see this written in other languages: `foo.en.md`, `foo.fr.md`, `foo.ja.md`
```md
Thank you for using MMG!
<!-- [en] -->
Tags within code blocks are treated as plain text.
```
foo.ja.mdも確認してください。MMGが各タグに応じてコンテンツを正しく分類していることがわかります。
# Hello, World!
これは日本語で「こんにちは、世のああ！」と書いたものです。
```md
Thank you for using MMG!
<!-- [en] -->
Tags within code blocks are treated as plain text.
```
一度に複数のファイルを変換する方法
MMGには、複数のファイルを一度に処理する方法が3つあります。
- (方法1) 複数のファイルを引数として入力する
- (方法2) 現在のパスからすべてのサブパスを再帰的に検索する
- (方法3) YAMLファイルでタスクを定義し、バッチで処理する
最初の方法では、スペースで区切って複数のファイルを入力できます。
mmg Foo.base.md Bar.base.md Baz.base.md
2番目の方法では、最初の方法と同様に、--recursiveまたは-rオプションを使用します。
詳細については、再帰オプションを参照してください。
最後に、3番目の方法については、YAMLファイルを使用したバッチ処理ページを参照してください。