Skip to content

Latest commit

 

History

History
360 lines (285 loc) · 16.1 KB

README.base.md

File metadata and controls

360 lines (285 loc) · 16.1 KB
Raw
Multilingual Markdown Generator

Multilingual Markdown Generator

This package provides a command-line interface to manage multilingual contents and generate i18n markdown from a single base file.

Générateur de Markdown Multilingue

Ce package fournit une interface de ligne de commande pour gérer les contenus multilingues et générer des démarques i18n à partir d'un seul fichier de base.

다국어 마크다운 생성기

이 패키지는 단일 기본 파일로부터 다국어 콘텐츠를 관리하고, i18n 마크 다운을 생성하는 명령 줄 인터페이스 (CLI)를 제공합니다.

多言語マークダウンジェネレータ

このパッケージは、単一のデフォルトのファイルから多言語コンテンツを管理してi18nマークダウンを生成するコマンドラインインタフェース（CLI）を提供しています。

PyPI - Version PyPI - Python Version GitHub code size in bytes PyPI - License

🌏

English | Français | 한국어 | 日本語

Available in Bash, Zsh, and Windows PowerShell.

English | Français | 한국어 | 日本語

Disponible dans Bash, Zsh et Windows PowerShell.

English | Français | 한국어 | 日本語

Bash, Zsh, Windows PowerShell에서 사용할 수 있습니다.

English | Français | 한국어 | 日本語

Bash, Zsh, WindowsPowerShellで使用できます。

Table of Contents ⚡

목차 ⚡

目次 ⚡

Table des matières ⚡

Overview 🔎

Aperçu 🔎

개요 🔎

概要 🔎

How It Works

By managing only one Base file, we can reduce the number of errors caused by missing or mismatched translations. Additionally, thanks to editing in a single file, we can expect convenient translation with the auto-completion function of AI tools such as Copilot.

Comment Ça Fonctionne

En gérant un seul fichier Base, nous pouvons réduire le nombre d'erreurs causées par des traductions manquantes ou incohérentes. De plus, grâce à l'édition dans un seul fichier, nous pouvons nous attendre à une traduction pratique avec la fonction de complétion automatique des outils AI tels que Copilot.

작동 방식

Base 파일 하나만 관리하기 때문에, 콘텐츠 번역이 누락되거나 불일치되는 실수를 줄일 수 있습니다. 또한 단일 파일에서 편집하는 덕분에, Copilot과 같은 AI 도구의 자동 완성 기능으로 편리한 번역을 기대할 수 있습니다.

作動方式

1 つの Base ファイルのみを管理することで、コンテンツの翻訳漏れや不一致によるエラーを減らすことができます。 また、単一ファイルで編集できるため、Copilot などの AI ツールの自動補完機能による便利な翻訳を期待できます。

Markdown:

How It Works: Markdown

Jupyter Notebook:

How It Works: Jupyter Notebook

Features

Supports the following features:

  • Markdown, Jupyter Notebook(.ipynb) as input formats
  • As-is, HTML, PDF as ouput formats
  • Command-line interface for Bash, Zsh, Windows PowerShell
  • Python API
  • Recursive traversal mode with -r option (As-is, HTML, PDF are all supported)
  • Batch processing mode with YAML file (Only As-is is supported)
  • IETF language tags
  • UTF-8 encoding
  • Automatic generation of table of contents with level and emoji options (Markdown and Jupyter Notebook are both supported)
  • Base file validation (Check the number of tags of each language)
  • Validation only mode for CI/CD (Disable file generation)

특징

다음 기능을 지원합니다:

  • Markdown, Jupyter Notebook(.ipynb)을 입력 형식으로 사용
  • As-is(있는 그대로), HTML, PDF 출력 형식
  • Bash, Zsh, Windows PowerShell용 명령줄 인터페이스
  • 파이썬 API
  • -r 옵션을 사용한 재귀 순회 모드 (As-is, HTML, PDF 모두 지원됨)
  • YAML 파일을 사용한 일괄 처리 모드 (As-is만 지원)
  • IETF 언어 태그
  • UTF-8 인코딩
  • 레벨 및 이모티콘 옵션이 포함된 목차 자동 생성 (Markdown 및 Jupyter Notebook 모두 지원)
  • Base 파일 유효성 검사 (언어별 태그 개수 확인)
  • CI/CD를 위한 유효성 검사 only 모드 (파일 생성 비활성화)

特徴

次の機能をサポートします。

  • Markdown、Jupyter Notebook（.ipynb）を入力形式で使用する
  • As-is(そのまま)、HTML、PDF出力形式
  • Bash、Zsh、Windows PowerShell用のコマンドラインインターフェイス
  • Python API
  • -rオプションを使用した再帰巡回モード（As-is、HTML、PDFの両方をサポート）
  • YAMLファイルを使用したバッチモード（As-isのみサポート）
  • IETF言語タグ
  • UTF-8エンコーディング
  • レベルと絵文字オプションを含む目次の自動生成（MarkdownとJupyter Notebookの両方をサポート）
  • Baseファイルの検証(言語別のタグ数の確認)
  • CI / CDのための検証のみモード（ファイル生成を無効にする）

Caractéristiques

Prend en charge les fonctionnalités suivantes :

  • Markdown, Jupyter Notebook(.ipynb) comme formats d'entrée
  • Tel quel, HTML, PDF comme formats de sortie
  • Interface de ligne de commande pour Bash, Zsh, Windows PowerShell
  • API Python
  • Mode de parcours récursif avec l'option -r (tels quels, HTML, PDF sont tous pris en charge)
  • Mode de traitement par lots avec fichier YAML (seul tel quel est pris en charge)
  • Étiquette d'identification de langues IETF
  • Encodage UTF-8
  • Génération automatique de table des matières avec options de niveau et options de emoji (Markdown et Jupyter Notebook sont tous deux pris en charge)
  • Validation du fichier de base (Vérifier le nombre de balises de chaque langue)
  • Mode validation uniquement pour CI/CD (désactiver la génération de fichiers)

Installation 📦

Installation 📦

설치 📦

設置 📦

Linux

pip3 install mmg

macOS

pip3 install mmg

If you have any issues with WeasyPrint, install it with the following command. WeasyPrint is only used to create PDFs.

Si vous rencontrez des problèmes avec WeasyPrint, installez-le avec la commande suivante. WeasyPrint est uniquement utilisé pour créer des PDF.

만약 WeasyPrint와 관련된 문제가 발생한다면, 아래 명령어으로 설치해주세요. WeasyPrint는 PDF를 생성할 때에만 사용됩니다.

WeasyPrintで問題が発生した場合は、次のコマンドでインストールしてください。WeasyPrintはPDFの作成にのみ使用されます。

brew install weasyprint

Windows

  1. MMG uses WeasyPrint to create PDFs. WeasyPrint requires the GTK library, so download and run the latest GTK3 installer. If you are not interested in creating PDFs, you can skip this step. Other features of MMG are available without GTK.
  2. Install MMG using Pip.
  1. MMG utilise WeasyPrint pour créer des PDF. WeasyPrint nécessite la bibliothèque GTK, alors téléchargez et exécutez le dernier installateur GTK3. Si vous n'êtes pas intéressé par la création de PDF, vous pouvez ignorer cette étape. Les autres fonctionnalités de MMG sont disponibles sans GTK.
  2. Installez MMG à l'aide de Pip.
  1. MMG는 WeasyPrint를 사용하여 PDF를 생성합니다. WeasyPrint는 GTK 라이브러리가 있어야 작동하므로, 최신 GTK3 설치 파일을 다운로드하고 실행하세요. PDF 생성 기능을 사용하지 않는다면 이 단계을 건너뛰어도 됩니다. GTK가 없더라도 MMG의 다른 기능들은 정상적으로 쓸 수 있습니다.
  2. Pip를 사용하여 MMG를 설치합니다.
  1. MMGはWeasyPrintを使用してPDFを作成します。WeasyPrintはGTKライブラリが必要なので、最新のGTK3インストーラーをダウンロードして実行します。PDFを作成することに興味がない場合は、このステップをスキップできます。 GTKがなくても、MMGの他の機能は使用できます。
  2. Pipを使用してMMGをインストールします。
```sh
pip3 install mmg
```

How to Use 💡

Please refer to the documentation for detailed usage and examples.

Mode d'emploi 💡

Veuillez vous référer à la documentation pour plus de détails sur l'utilisation et des exemples.

사용법 💡

자세한 사용법과 예제는 문서를 참고해주세요.

使用方法 💡

詳細な使用方法と例は、ドキュメントを参照してください。

$ mmg --help
Usage: mmg [OPTIONS] [FILE_NAMES]...

  FILE_NAMES: Base file names to convert. `*.base.md` or `*.base.ipynb` are
  available.

  Here are some examples:

      mmg *.base.md

      mmg *.base.ipynb

      mmg *.base.md *.base.ipynb -o pdf --css github-dark

      mmg --recursive

      mmg --recursive --validation-only

      mmg --batch mmg.yml

Options:
  -r, --recursive                 This will search all subfolders based on
                                  current directory.
  -b, --batch FILE                YAML file path for batch conversion.
                                  (Default: None)
  -o, --output-format [as-is|html|pdf]
                                  Output format. (Default: as-is)
  --css TEXT                      CSS file path or preset('github-
                                  light'/'github-dark'). Only for the HTML/PDF
                                  output. (Default: github-light)
  -y, --yes                       This will confirm the conversion without
                                  asking. (Default: False)
  -s, --skip-validation           Skip the health check. (Default: False)
  --validation-only               Only check the health. (Default: False)
  -v, --verbose                   Verbosity level from 0 to 2. --verbose:1,
                                  -v:1, -vv:2 (Default: 0)
  --version                       Show the current version.
  --help                          Show this message and exit.

Troubleshooting 💊

Please refer to the troubleshooting page on the website.

Dépannage 💊

Veuillez vous référer à la page dépannage sur le site web.

문제 해결 💊

문제 해결 페이지를 참고해주세요.

トラブルシューティング 💊

トラブルシューティングページを参照してください。

Changelog 📝

CHANGELOG.md

Contributors 🤝

Contributeurs 🤝

기여하신 분들 🤝

貢献された方々 🤝

Made with contrib.rocks.

If you are interested in how to contribute, please refer to the contribution guide.

Réalisé avec contrib.rocks.

Si vous êtes intéressé par la façon de contribuer, veuillez vous référer au guide de contribution.

contrib.rocks로 만들었습니다.

기여 방법에 관심이 있으시다면, 기여 가이드를 참고해주세요.

contrib.rocksで作りました。

貢献方法に興味がある方は、貢献ガイドを参照してください。