add README for pdf-converter

apps/pdf-converter/README.md

@@ -0,0 +1,28 @@
+[日本語 🇯🇵](./README_JP.md)
+
+# About this app
+GROWI provides a feature that bulk exports pages in PDF format, which can be executed from the page menu.
+This app (PDF-Converter) is necessary to convert markdown pages to PDF during that process.
+
+# Development
+## Spec (only in Japanese)
+[/資料/内部仕様/Page Bulk Export/PDF エクスポート](https://dev.growi.org/66ee8495830566b31e02c953)
+
+## Developing inside a devcontainer
+1. Open VSCode
+1. Open command palette (Windows: Ctrl + Shift + P, Mac: Cmd + Shift + P)
+1. Choose `Dev Containers: Open folder in Container...`
+1. Choose the root growi directory you have cloned from https://github.com/weseek/growi
+    - Not the PDF-Converter directory (growi/apps/pdf-converter)
+1. Choose `GROWI-PDF-Converter` as the container to open
+1. Execute `cd apps/pdf-converter && turbo dev:pdf-converter` to start the pdf-converter app
+1. Edit files in apps/pdf-converter for development
+
+## Requesting PDF-Converter from GROWI (both running in a devcontainer)
+1. Open VSCode and open GROWI devcontainer
+    - Choose `GROWI-Dev` for the container to open
+1. Open a new VSCode window and open PDF-Converter devcontainer
+    - Follow [Developing inside a devcontainer](#developing-inside-a-devcontainer)
+1. Start both apps
+1. Request PDF bulk export from the page menu in the GROWI app
+    - It might take a few minutes, depending on GROWI's configurations

apps/pdf-converter/README_JP.md

@@ -0,0 +1,28 @@
+[English 🇺🇸](./README.md)
+
+# このアプリについて
+GROWI には、ページを PDF 形式で一括エクスポートする機能があり、ページメニューから実行できます。
+このアプリ（PDF-Converter）は、そのプロセスの中で Markdown ページを PDF に変換するために必要です。
+
+# 開発
+## 内部仕様
+[/資料/内部仕様/Page Bulk Export/PDF エクスポート](https://dev.growi.org/66ee8495830566b31e02c953)
+
+## Devcontainer 内での開発
+1. VSCode を開く
+1. コマンドパレットを開く（Windows: `Ctrl + Shift + P`、Mac: `Cmd + Shift + P`）
+1. `Dev Containers: Open folder in Container...` を選択
+1. [https://github.com/weseek/growi](https://github.com/weseek/growi) からクローンした GROWI のルートディレクトリを選択
+   - **PDF-Converter のディレクトリ（growi/apps/pdf-converter）ではなく、GROWI のルートディレクトリを選択すること**
+1. `GROWI-PDF-Converter` をコンテナとして選択
+1. `cd apps/pdf-converter && turbo dev:pdf-converter` を実行し、PDF-Converter アプリを起動
+1. `apps/pdf-converter` 内のファイルを編集して開発を行う
+
+## GROWI から PDF-Converter へのリクエスト（両方とも devcontainer 内で実行）
+1. VSCode を開き、GROWI の devcontainer を開く
+   - `GROWI-Dev` をコンテナとして選択
+1. 新しい VSCode ウィンドウを開き、PDF-Converter の devcontainer を開く
+   - [Devcontainer 内での開発](#devcontainer-内での開発) の手順に従う
+1. 両方のアプリを起動
+1. GROWI アプリのページメニューから PDF の一括エクスポートをリクエスト
+   - GROWI の設定によっては、処理に数分かかる場合があります