manidoc ユーザーマニュアル

各プロジェクト行の右端にあるドロップダウン（コンボボックス）からタグを選ぶだけです。 「（なし）」を選ぶとタグなし状態に戻ります。

スタート画面の「🏷 タグ管理」ボタンを押すと タグ管理ダイアログ が開きます。

スタート画面の「タグでグループ化」ボタンを押すと、プロジェクト一覧がタグごとにまとめて表示されます。 もう一度押すと通常表示（SortOrder 順）に戻ります。

「🌐 Web 一括出力」を実行したとき、タグが設定されているプロジェクトが 1 件以上ある場合は 階層構造 で出力されます。

出力フォルダ/
├── index.html          ← トップページ（タグタイル + タグなしプロジェクト）
├── tag_0/
│   ├── index.html      ← タグ「操作マニュアル」のサブページ（プロジェクトタイル）
│   └── tagimg.png      ← タグ画像（設定した場合）
├── tag_1/
│   └── index.html      ← タグ「設定ガイド」のサブページ
├── a/                  ← 各プロジェクトの HTML（従来通り）
└── b/

• トップページ：タグをカード形式で一覧。各カードをクリックするとそのタグのサブページへ。
• タグサブページ：そのタグに属するプロジェクトを一覧表示。「← トップへ戻る」リンク付き。
• タグなしプロジェクト：トップページの下部に「（タグなし）」セクションとして直接表示。
• タグが 1 件も設定されていない場合は従来通りのフラット構造で出力されます。

Markdown 形式（.md）のテキストファイルを選択してプロジェクトに取り込みます。 既存の Markdown 資料をそのまま Manidoc で編集・管理したいときに使います。

HTML 形式（.html）のファイルを選択してプロジェクトに取り込みます。 Web ページを保存したファイルや HTML で書かれたドキュメントを取り込めます。

URL を入力してウェブページを直接取り込みます。 公開されているページの内容をそのまま Manidoc プロジェクトとして編集できます。

「保存」ボタンを押すと、現在のプロジェクトのすべてのノードをファイルに保存します。

「再読み込み」ボタンを押すと、ファイルから最新の内容を読み込みます。 外部から変更があった場合や、変更を破棄してファイルの状態に戻したいときに使います。

URL を入力して「ブラウザ起動」ボタンを押すと、アプリ内のブラウザでそのページを開きます。 開いたページのキャプチャをノードの画像として取り込む操作と組み合わせて使えます。

ツールバーの「テーマ切替」ボタンで、アプリ全体のライトモードとダークモードを切り替えます。 設定は次回起動時も引き継がれます。

一番上のテキスト欄に見出しを入力します。

文章を入力するエリアです。 ツールバーのボタンで 太字・斜体・取消線・箇条書き・番号付きリスト・表などの書式を付けられます。 よく使うボタン： 「✨ AIアシスタント」ボタンを押すと、AI が文章の改善案を提案します。 「📝 編集拡大」ボタンを押すと、広い画面で編集できます。

ツールバー右端の「－」「＋」ボタンで文字の表示倍率を変えられます。 現在の倍率はボタン間にパーセントで表示されます（例：100%）。 Ctrl + マウスホイール でも倍率を変えられます。

• 範囲：50% ～ 300%
• 設定は記事エリア・コメントエリアそれぞれ個別に保存されます
• アプリを終了して再起動しても前回の倍率が維持されます

ノードに1枚の画像を紐付けられます。

• 「画像を選択」：手持ちの画像ファイルを選ぶ
• 「✨ AI で画像を生成」：テキストで説明すると AI が画像を自動生成する
• 「編集」：画像にトリミング・枠線・文字を追加する
• 「クリア」：設定した画像を削除する 画像ファイルはプロジェクトフォルダ内の images フォルダに自動保存されます。

画像エリアの上下にボタンがあり、作業内容に応じてエリアの広さを切り替えられます。

記事とは別に、注意事項や補足情報を書く欄です。 HTML 出力時に記事の下に「補足」として表示されます。

ツールバーの「目次をつける」チェックボックスをオンにすると、HTML 出力時にページ上部に目次が自動生成されます。 チェックを外すと目次なしで出力されます。

製品名やテーマのリストを用意しておけば、AI がそれぞれのドキュメントを自動で作り上げます。

// 製品リストを読み込み、各製品のマニュアルをAIに自動生成させる
var products = manidoc.readFile("data/products.txt").split("\n");

for (var i = 0; i < products.length; i++) {
    var name = products[i].trim();
    if (name === "") continue;

    var md = manidoc.askAIText(name + "の操作マニュアルをMarkdownで書いてください。## で章を分けること。");
    var proj = manidoc.createProject(name + " マニュアル");
    var top = proj.addNode("はじめに");
    top.importMarkdown(md);
    proj.save();
    manidoc.log(name + " 完了");
}

アプリの画面を順番にキャプチャして、対応するノードへ自動的に挿入できます。

// 開いているアプリの画面を順番にキャプチャしてノードに貼り付ける
var proj = manidoc.openProject("操作マニュアル");
var steps = ["ログイン画面", "メインメニュー", "設定画面"];

for (var i = 0; i < steps.length; i++) {
    var node = proj.findNode(steps[i]);
    if (node === null) node = proj.addNode(steps[i]);

    var path = manidoc.captureWindow("MyApp", "screenshots/" + i + ".png");
    node.setImage(path);
    manidoc.log(steps[i] + " キャプチャ完了");
    manidoc.sleep(1000);
}
proj.save();

HTML 書き出し → Git コミット → FTP アップロードまでをボタン1つで完結できます。

// HTML出力してGitにコミット、FTPでサーバーにアップロード
var proj = manidoc.openProject("製品マニュアル");
var htmlPath = proj.exportHtml(true);
manidoc.log("HTML出力: " + htmlPath);

// Git コミット
var git = manidoc.execute("git add . && git commit -m \"マニュアル更新\"");
manidoc.log(git.success ? "Gitコミット完了" : "Gitエラー: " + git.error);

// FTP アップロード
var ftp = manidoc.execute("curl -T export/index.html ftp://user:pass@example.com/public_html/", 60);
manidoc.log(ftp.success ? "FTPアップロード完了" : "FTPエラー: " + ftp.error);

全プロジェクトを両形式で一括書き出しできます。

// 全プロジェクトをHTML・Markdownの両形式で一括書き出し
var names = manidoc.getProjects();
manidoc.log("対象: " + names.length + " プロジェクト");

for (var i = 0; i < names.length; i++) {
    var proj = manidoc.openProject(names[i]);
    if (proj === null) continue;

    var html = proj.exportHtml(true);
    var md   = proj.exportMarkdown();
    manidoc.log(names[i] + " → HTML: " + html);
    manidoc.log(names[i] + " → MD:   " + md);
}
manidoc.log("一括書き出し完了");

新しいプロジェクトを作成します。

var proj = manidoc.createProject("新しいマニュアル");

既存のプロジェクトを名前で開きます。名前は部分一致で検索します。 見つからない場合は null が返ります。

var proj = manidoc.openProject("社内システム");
if (proj === null) {
    manidoc.log("プロジェクトが見つかりません");
}

正規表現パターンにマッチするプロジェクトを開きます。 名前が完全にわかっていないときや、条件で絞り込みたいときに使います。 見つからない場合は null が返ります。

// 「2026」という文字を含むプロジェクトを開く
var proj = manidoc.openProjectByRegex("2026");

// 「製品」で始まるプロジェクトを開く
var proj = manidoc.openProjectByRegex("^製品");

if (proj === null) {
    manidoc.log("該当プロジェクトが見つかりません");
}

ワークスペース内の全プロジェクト名を配列で返します。

var names = manidoc.getProjects();
for (var i = 0; i < names.length; i++) {
    manidoc.log(names[i]);
}

プロジェクトを完全に削除します。元に戻せないので注意してください。

manidoc.deleteProject("不要なプロジェクト");

Markdown ファイルからプロジェクトをインポートします。 パスはワークスペースフォルダからの相対パスで指定できます。

var proj = manidoc.importFromMarkdown("docs/manual.md");

変更内容をファイルに保存します。編集後は必ず呼んでください。

proj.name = "新しい名前";
proj.save();

ルートノードを追加します。追加されたノードを返します。

var node = proj.addNode("第1章 基本操作");

ルートノードをタイトルで検索します。完全一致です。

var node = proj.getNode("第1章 基本操作");

全階層（子ノード含む）からタイトルで検索します。

var node = proj.findNode("ログイン方法");

全ルートノードを配列で返します。

var nodes = proj.getNodes();
for (var i = 0; i < nodes.length; i++) {
    manidoc.log(nodes[i].title);
}

指定タイトルのルートノードを削除します。

proj.removeNode("不要な章");
proj.save();

プロジェクトを HTML ファイルとして書き出します。 出力された index.html のパスを返します。

var path = proj.exportHtml(true);   // true = 目次あり
manidoc.log("出力先: " + path);

プロジェクトを Markdown ファイルとして書き出します。 出力されたファイルのパスを返します。

var path = proj.exportMarkdown();
manidoc.log("出力先: " + path);

node.title = "ログイン方法";
node.article = "## 手順\n1. ID を入力\n2. パスワードを入力\n3. ログインボタンを押す";
node.comment = "パスワードは8文字以上が必要です。";
proj.save();

子ノードを追加します。

var parent = proj.addNode("基本操作");
var child = parent.addChild("ログイン方法");
child.article = "ログインの手順です。";
proj.save();

直接の子ノードをタイトルで検索します。

var child = node.getChild("ログイン方法");

全子ノードを配列で返します。

var children = node.getChildren();

画像ファイルをノードに設定します。 ファイルはプロジェクトの images フォルダに自動コピーされます。

node.setImage("screenshots/login.png");
proj.save();

画像を圧縮してからノードに設定します。ファイルサイズを小さくしたいときに使います。

// 品質80、最大1920px でリサイズして設定
node.setOptimizedImage("screenshots/login.png", 80, 1920);
proj.save();

ノードに設定されている画像を削除します。

node.clearImage();
proj.save();

Markdown テキストをパースして、このノードの子ノードとして追加します。 AI の応答をそのまま渡してノード構造を自動生成する用途に便利です。

• 先頭の # 見出し はこのノードのタイトルに使用されます
• ## 以降の見出しが子ノードになります（階層も維持されます）
• 戻り値は追加された子ノードの配列です

var node = proj.addNode("第1章 基本操作");

// AI に Markdown で内容を書かせて、子ノードとして展開
var md = manidoc.askAIText("「基本操作」の操作マニュアルを Markdown で書いて。## で各手順を分けること。");
node.importMarkdown(md);

proj.save();

指定した名前のウィンドウをキャプチャして画像ファイルに保存します。 ウィンドウタイトルは部分一致で検索します。

var path = manidoc.captureWindow("Google Chrome", "screenshots/chrome.png");
node.setImage(path);
proj.save();

Manidoc 自身のウィンドウをキャプチャして保存します。 ウィンドウタイトルの指定は不要です。

var path = manidoc.captureSelf("screenshots/manidoc.png");
node.setImage(path);
proj.save();

テキストファイルを読み込んで内容を返します。

var text = manidoc.readFile("data/list.txt");

テキストファイルを書き込みます。ファイルが存在しない場合は新規作成します。

manidoc.writeFile("output/result.txt", "処理完了");

ファイルまたはフォルダが存在するか確認します。

if (manidoc.fileExists("data/list.txt")) {
    manidoc.log("ファイルあり");
}

ファイルまたはフォルダを削除します。

manidoc.deleteFile("output/old_result.txt");

実行ログにメッセージを記録します。スクリプトタブのログエリアに表示されます。

manidoc.log("処理が完了しました");

これまでに記録した全ログを1つの文字列にまとめて返します。

var allLog = manidoc.getLog();

これまでのログをファイルに保存します。

manidoc.saveLog("logs/run_log.md");

現在の日時を yyyy/MM/dd HH:mm:ss 形式の文字列で返します。

manidoc.log("実行日時: " + manidoc.now());

ワークスペースフォルダの絶対パスを返します。

manidoc.log("ワークスペース: " + manidoc.getWorkspacePath());

指定した時間（ミリ秒）だけ処理を止めて待ちます。

manidoc.sleep(1000);  // 1秒待つ

スクリプト API のバージョンを返します。

manidoc.log("API バージョン: " + manidoc.version());

スクリプトの実行タイムアウトを変更します。 スクリプトの先頭行に書く必要があります。 途中に書いても効果はありません。

// 例1：タイムアウトを5分（300秒）に延長する
manidoc.setTimeout(300);

// 例2：タイムアウトを無制限にする（長時間バッチ処理向け）
manidoc.setTimeout(0);

manidoc.log("処理開始");
// ... 長い処理 ...
manidoc.log("完了");

ブラウザ起動と同時に画面左上にフローティングウィンドウが表示されます。 ウィンドウはドラッグして移動できます。

キャプチャ画像の保存先: {プロジェクトフォルダ}/captures/cap_yyyyMMdd_HHmmss_NNN.png

⏹ 停止して保存 を押すと {ワークスペース}/scripts/rec_yyyyMMdd_HHmmss.js が生成されます。 スクリプトタブから実行すると、同じ操作を Chromium で再現できます。

システムにインストール済みの Microsoft Edge または Google Chrome を起動し、ブラウザ操作オブジェクトを返します。 Edge または Chrome がインストールされていない環境では起動できません。

var browser = manidoc.openBrowser("https://example.com");
// 操作後は必ず閉じる
browser.close();

返されるオブジェクトのメソッド： セレクターの例：

browser.click("#login-btn");           // ID
browser.fill("[name='username']", "admin");  // name属性
browser.click("text=ログイン");         // テキスト
browser.fill("[placeholder='パスワード']", "pass"); // placeholder

スクリーンショットの保存先： ワークスペースの captures/ フォルダに自動保存されます。

var path = browser.screenshot();  // "captures/cap_20260306_143022_000.png"
var node = proj.addNode("手順1");
node.setImage(path);

テキスト入力ダイアログを表示します。 OK を押すと入力した文字列が返ります。キャンセルすると空文字 "" が返ります。

var name = manidoc.inputBox("プロジェクト名を入力してください");
if (name === "") {
    manidoc.log("キャンセルされました");
} else {
    var proj = manidoc.createProject(name);
    proj.save();
}

コンボボックス付きの選択ダイアログを表示します。 選択肢は カンマ区切りの文字列で指定します。 OK を押すと選択した値が返ります。キャンセルすると空文字 "" が返ります。

var category = manidoc.selectionBox("カテゴリを選んでください", "操作マニュアル,設定ガイド,FAQ,リリースノート");
if (category !== "") {
    manidoc.log("選択: " + category);
}

• 指示書パス はワークスペースからの相対パスで .md ファイルを指定します
• Web検索 を true にするとインターネット検索を使います（有料プランのみ・Gemini API 使用時のみ有効。ローカルLLM使用時は無視されます）
• システムプロンプト は省略できます

{
    success: true,       // 成功したか
    response: "...",     // AI の応答テキスト（success=true のとき）
    error: ""            // エラーメッセージ（success=false のとき）
}

// ── パターン1: シンプルな呼び出し ──────────────────────────
try {
    var md = manidoc.askAI("prompts/request.md");
    var proj = manidoc.importFromMarkdown("temp/draft.md");
    manidoc.writeFile("temp/draft.md", md);
    proj.save();
    manidoc.log("完了: " + proj.name);
} catch (e) {
    manidoc.log("エラー: " + e.message);
}

// ── パターン2: エラーを変数で受け取る ─────────────────────
var result = manidoc.askAIResult("prompts/request.md");
if (!result.success) {
    manidoc.log("失敗: " + result.error);
} else {
    manidoc.log(result.response);
}

// ── パターン3: テキストを直接渡す ─────────────────────────
var r = manidoc.askAITextResult("Pythonのインストール手順をMarkdownで書いてください");
if (r.success) manidoc.log(r.response);

テストケースを開始します。

manidoc.testStart("プロジェクト作成テスト");

条件が偽のとき FAIL を記録します。

var proj = manidoc.openProject("テスト");
manidoc.assert(proj !== null, "プロジェクトが存在すること");

2つの値が等しくない場合に FAIL を記録します。

manidoc.assertEqual(3, proj.nodeCount, "ノード数が3であること");

ファイルが存在しない場合に FAIL を記録します。

manidoc.assertFileExists("output/result.html", "HTML が出力されていること");

テスト結果を明示的に記録します。

if (proj !== null) {
    manidoc.testPass("プロジェクトが見つかった");
} else {
    manidoc.testFail("プロジェクトが見つからなかった");
}

テスト結果のまとめを返します。{ total, passed, failed, results[] } 形式です。

var summary = manidoc.getTestSummary();
manidoc.log("合計: " + summary.total + " / 合格: " + summary.passed + " / 不合格: " + summary.failed);

外部コマンドを実行します。Git・SFTP などのツールをスクリプトから呼び出せます。 タイムアウト秒は省略すると 30 秒です。 戻り値は { success, exitCode, output, error } 形式のオブジェクトです。

var result = manidoc.execute("git status");
if (result.success) {
    manidoc.log(result.output);
} else {
    manidoc.log("エラー: " + result.error);
}

指定フォルダ内の manifest.json に登録されたスクリプトファイルのパス一覧を返します。 サブフォルダ名を省略すると "recordings" フォルダが対象になります。

var scripts = manidoc.listScripts("recordings");
for (var i = 0; i < scripts.length; i++) {
    manidoc.log(scripts[i]);
}

別のスクリプトファイルを実行キューに追加します。 現在のスクリプトが終了した後に順番に実行されます。

manidoc.runScript("scripts/export_all.js");

var names = manidoc.getProjects();
manidoc.log("プロジェクト数: " + names.length);
for (var i = 0; i < names.length; i++) {
    manidoc.log((i + 1) + ". " + names[i]);
}

var proj = manidoc.createProject("操作マニュアル");
proj.description = "システムの基本操作説明書";

var ch1 = proj.addNode("第1章 はじめに");
ch1.article = "このマニュアルでは基本的な使い方を説明します。";

var ch2 = proj.addNode("第2章 基本操作");
ch2.addChild("ログイン方法");
ch2.addChild("ログアウト方法");

proj.save();
manidoc.log("プロジェクト作成完了: " + proj.name);

var proj = manidoc.openProject("操作マニュアル");
var node = proj.findNode("ログイン方法");

var imgPath = manidoc.captureSelf("screenshots/login_screen.png");
node.setImage(imgPath);
proj.save();

manidoc.log("キャプチャ完了");

var names = manidoc.getProjects();
for (var i = 0; i < names.length; i++) {
    var proj = manidoc.openProject(names[i]);
    if (proj !== null) {
        var path = proj.exportHtml(true);
        manidoc.log(names[i] + " → " + path);
    }
}
manidoc.log("一括出力完了");

実行中にユーザーへ名前やカテゴリを尋ねて、その内容でプロジェクトを作成します。

// プロジェクト名を入力させる
var projName = manidoc.inputBox("作成するプロジェクトの名前を入力してください");
if (projName === "") {
    manidoc.log("キャンセルされました");
} else {
    // カテゴリを選択させる
    var category = manidoc.selectionBox(
        "ドキュメントの種類を選んでください",
        "操作マニュアル,設定ガイド,FAQ,リリースノート,提案書"
    );

    var proj = manidoc.createProject(projName);
    proj.description = category !== "" ? category : "ドキュメント";

    // カテゴリに応じた初期構成を追加
    if (category === "操作マニュアル") {
        proj.addNode("はじめに");
        proj.addNode("基本操作");
        proj.addNode("よくある質問");
    } else if (category === "FAQ") {
        proj.addNode("インストール");
        proj.addNode("使い方");
        proj.addNode("トラブルシューティング");
    } else {
        proj.addNode("概要");
        proj.addNode("詳細");
    }

    proj.save();
    manidoc.log("作成完了: " + proj.name + "（" + proj.description + "）");
}

テキストファイルに書いたデータを読み込んで、ノード構造に展開します。

// data/chapters.txt の内容例:
// 第1章 はじめに
// 第2章 基本操作
// 第3章 応用編

var text = manidoc.readFile("data/chapters.txt");
var lines = text.split("\n");

var proj = manidoc.createProject("自動生成マニュアル");

for (var i = 0; i < lines.length; i++) {
    var title = lines[i].trim();
    if (title === "") continue;
    var node = proj.addNode(title);
    node.article = "## " + title + "\n\nここに内容を記載します。";
    manidoc.log("追加: " + title);
}

proj.save();

// 処理結果をファイルに記録
manidoc.writeFile("logs/chapter_import.txt",
    manidoc.now() + " " + proj.name + " 作成完了（" + proj.nodeCount + "章）");
manidoc.log("完了: " + proj.nodeCount + " 章を作成しました");

フォルダにある複数の .md ファイルをそれぞれ別プロジェクトとして取り込みます。

var files = ["input/manual_a.md", "input/manual_b.md", "input/manual_c.md"];

for (var i = 0; i < files.length; i++) {
    var path = files[i];

    if (!manidoc.fileExists(path)) {
        manidoc.log("スキップ（ファイルなし）: " + path);
        continue;
    }

    manidoc.log("インポート中: " + path);
    var proj = manidoc.importFromMarkdown(path);
    proj.save();

    var htmlPath = proj.exportHtml(true);
    manidoc.log("完了: " + proj.name + " → " + htmlPath);
}

manidoc.log("全インポート完了: " + manidoc.now());

「2025」を含む古いプロジェクトを探し出し、タイトルを自動で置き換えます。

var names = manidoc.getProjects();
var count = 0;

for (var i = 0; i < names.length; i++) {
    // 名前に「2025」が含まれるプロジェクトが対象
    if (names[i].indexOf("2025") === -1) continue;

    var proj = manidoc.openProject(names[i]);
    if (proj === null) continue;

    var oldName = proj.name;
    proj.name = oldName.replace("2025", "2026");
    proj.save();

    manidoc.log("更新: " + oldName + " → " + proj.name);
    count++;
}

manidoc.log("更新完了: " + count + " 件");

Web システムにログインし、主要画面を順番にキャプチャしてノードに貼り付けます。

var proj = manidoc.openProject("Webシステム操作マニュアル");
if (proj === null) proj = manidoc.createProject("Webシステム操作マニュアル");

var browser = manidoc.openBrowser("https://example.com/login");

// ログイン操作
browser.fill("[name='username']", "admin");
browser.fill("[name='password']", "password");
browser.click("text=ログイン");
browser.waitForUrl("dashboard");

// ダッシュボード画面をキャプチャ
var node1 = proj.addNode("ダッシュボード");
var shot1 = browser.screenshot();
node1.setImage(shot1);
node1.article = "ログイン後に表示されるトップ画面です。";

// 設定画面に移動してキャプチャ
browser.goto("https://example.com/settings");
var node2 = proj.addNode("設定画面");
var shot2 = browser.screenshot();
node2.setImage(shot2);
node2.article = "各種設定を変更する画面です。";

browser.close();
proj.save();
manidoc.log("キャプチャ完了: " + proj.nodeCount + " 画面");

プロジェクト内の全画像を圧縮・リサイズしてファイルサイズを削減します。

var proj = manidoc.openProject("操作マニュアル");
var nodes = proj.getNodes();
var count = 0;

for (var i = 0; i < nodes.length; i++) {
    var node = nodes[i];
    var imgPath = node.imagePath;

    if (imgPath === "" || imgPath === null) continue;

    // 品質80、最大1280pxで最適化して上書き設定
    node.setOptimizedImage(imgPath, 80, 1280);
    count++;
    manidoc.log("最適化: " + node.title);
}

proj.save();
manidoc.log("最適化完了: " + count + " 件の画像を処理しました");

マニュアルの必須項目が揃っているかをスクリプトで自動チェックします。

manidoc.log("品質チェック開始: " + manidoc.now());

var names = manidoc.getProjects();

for (var i = 0; i < names.length; i++) {
    var proj = manidoc.openProject(names[i]);
    if (proj === null) continue;

    manidoc.testStart(proj.name);

    // ルートノードが1つ以上あること
    manidoc.assert(proj.nodeCount > 0, "ノードが存在すること");

    // 「はじめに」または「概要」ノードがあること
    var intro = proj.findNode("はじめに");
    var overview = proj.findNode("概要");
    manidoc.assert(intro !== null || overview !== null, "導入ノードが存在すること");

    // HTML 出力ファイルが存在すること
    var htmlExists = manidoc.fileExists("export/" + proj.name + "/index.html");
    manidoc.assert(htmlExists, "HTML出力済みであること");
}

var summary = manidoc.getTestSummary();
manidoc.log("チェック結果: " + summary.passed + "/" + summary.total + " 合格");

// 結果をファイルに保存
manidoc.saveLog("logs/quality_check_" + manidoc.now().replace(/[/ :]/g, "") + ".txt");