빠른 시작을 위한 예제
이 페이지에서는 Base 파일을 만들고 변환하는 가장 기초적인 방법을 설명합니다.
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.
```
여기서 소개하지 않은 기능들은 "베이스 파일 만들기" 페이지를 참고하세요.
이제 MMG를 사용할 준비가 되었습니다!
다음 단계에서는 en, fr, ko, ja 파일을 생성해보겠습니다.
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.en.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.ko.md도 확인해보세요. MMG가 각 태그에 따라 제대로 내용을 분류하는 것을 확인할 수 있습니다.
# Hello, World!
이것은 한국어로 "안녕, 세상아!"라고 쓴 것입니다.
```md
Thank you for using MMG!
<!-- [en] -->
Tags within code blocks are treated as plain text.
```
한 번에 여러 파일 변환하기
MMG가 여러 파일을 한 번에 처리하는 방식에는 세 가지가 있습니다.
- (방법 1) 인자로 여러 파일을 입력하는 방식
- (방법 2) 현재 경로에서 모든 하위 경로를 재귀적으로 탐색하는 방식
- (방법 3) YAML 파일에 작업을 정의하여 일괄 처리하는 방식
첫 번째 방법의 경우, 띄워쓰기로 구분하여 여러 파일을 입력하면 됩니다.
mmg Foo.base.md Bar.base.md Baz.base.md
두 번째 방법의 경우, --recursive 또는 -r 옵션을 사용하면 되고, 첫 번째 방법과 함께 사용할 수도 있습니다.
자세한 내용은 재귀 옵션을 참고하세요.
마지막으로 세 번째 방법에 대해서는 YAML 파일을 사용한 일괄 처리 페이지를 참고하세요.