Document Editor

ヘルプ

ヘルプ

Office やアカウントなしで DOCX、XLSX、PPTX、CSV をブラウザで開き、表示・編集できます。基本編集にアップロードは不要で、オフライン利用はキャッシュ済みリソースに依存します。

開く・新規作成する

どのファイル形式を開けますか?

Word(.docx、旧形式の .doc)、Excel(.xlsx、旧形式の .xls)、PowerPoint(.pptx、旧形式の .ppt)、カンマ区切り値(.csv)、PDF(.pdf)です。開くからファイルを選ぶか、ページにドラッグ&ドロップするか、/editor?file=https://… / /editor?src=https://… で URL を渡してください(ファイルを配信するサーバーがクロスオリジン要求を許可している必要があります)。

新しいドキュメントを作るには?

基本的なファイルの読み込み、編集、形式変換はブラウザ内でローカルに実行され、ドキュメントのアップロードは不要です。 自動保存が有効な場合、復元用コピーはこのブラウザの IndexedDB に最後の編集または読み込みから 7 日間保持されます。タブを閉じても削除されません。/history でコピーを削除したり自動保存を無効にしたりできます。ブラウザの保存領域は消去や回収の対象になり、未保存の編集は失われる可能性があります。復元機能はファイルの正式な保存の代わりにはなりません。

ファイルサイズの上限はありますか?

固定の上限はありません。ドキュメント全体をローカルで解析して描画するため、実質的な上限は端末のメモリです。

編集と保存

変更を保存するには?

File System Access API 対応の Chrome や Edge では、最初の保存でファイルを選択し、その後は同じファイルに書き戻します。他のブラウザではコピーをダウンロードします。別の形式はファイル → 名前を付けてダウンロードから書き出します。ブラウザ内の復元用コピーは保存したファイルとは別です。

保存ボタンが灰色のままなのはなぜですか?

保存ボタンは、エディタがドキュメントを完全に読み込み、かつ変更を加えたときに有効になります。編集しても灰色のままなら、ドキュメントの読み込みが完了していません——通知トーストにエラーが出ていないか確認し、下のエラーコードの節をご覧ください。

形式を相互に変換できますか?

はい、お使いの端末上でできます。ドキュメントを開き、名前を付けてダウンロードで目的の形式を選びます。Word 文書は DOCX / PDF / TXT へ、表計算は XLSX / CSV / PDF へ、プレゼンテーションは PPTX / PDF へ書き出せます。CSV は表計算として開かれ、CSV として保存し直せます。

日本語や中国語の CSV が他のツールで文字化けします。ここではどうですか?

エディタは開く前に CSV のエンコーディングを判定します——まず厳密な UTF-8、次に GB18030(中国語版 Excel が書き出す「ANSI」エンコーディング)、最後に Latin-1 の順です。そのため他のツールで文字化けするファイルも正しく開けます。保存時はバイトオーダーマーク付きの UTF-8 で書き出すため、Excel でもウィザードなしに開けます。

PDF

PDF で何ができますか?

開いて読む(スクロール、ズーム、検索)、コメントやフリーテキストの注釈を付ける、そしてその注釈を保持したまま PDF として再びダウンロードできます。入力可能なフォームへの記入もできます。

既存の PDF の本文を Word のように書き換えられますか?

自由に流し込めるテキストとしては書き換えられません——PDF は固定レイアウトの形式です。文言を変えたい場合は、元の DOCX / XLSX / PPTX を開いて新しい PDF を書き出してください。どちらの手順もお使いの端末上で行われます。

読み取り専用と埋め込み

ドキュメントを読み取り専用で開けますか?

はい。/editor?file= のリンクに &readonly=1 を付けるか、埋め込み API で document:set-readonly を送ってください。読み取り専用は、ドキュメントを再読み込みせずに実行中に切り替えられます。

自分の Web アプリの中にエディタを置けますか?

はい——エディタは iframe に埋め込んで postMessage で操作できるように設計されています。あなたのページが(自前の認証で)ファイルを取得し、iframe に送り込み、編集後の File を受け取って好きな場所へアップロードします。Embed API リファレンスとライブデモをご覧ください。

ブラウザの AI エージェント(WebMCP)

ブラウザの AI アシスタントにエディタを操作させられますか?

WebMCP ツールの編集と変換はローカルですが、ブラウザエージェントは文書のテキストや書き出したファイルを取得し、自身の AI サービスに送信する可能性があります。機密情報を渡す前にエージェントのデータ方針を確認してください。

どのブラウザが対応していますか?

WebMCP は W3C Web Machine Learning Community Group の提案で、現在は Chrome でオリジントライアルとして利用できます。Firefox と Safari は対応を表明していません。API を提供しないブラウザでは何も登録されず、動作も変わりません——純粋な追加機能です。

埋め込まれたエディタでも動きますか?

設計上、動きません。ツールはエディタがトップレベルのページであるときにのみ登録されます。クロスオリジンの iframe では埋め込み側ページが allow="tools" を付与する必要があり、それは埋め込みの本来の使い方と衝突します——エディタを埋め込む場合は、代わりに Embed API で操作してください。

エージェントはドキュメントの本文を読めますか?

ワープロ文書であれば読めます。get_document_text が本文を返すため、エージェントは何も書き出さずに内容についての質問に答えられます。表計算とプレゼンテーションはこのエンジンでは全文を公開していません。ツールは(空のファイルに見えてしまう空の答えを返す代わりに)その旨を明示し、書き出しを使うよう案内します。

オフラインとインストール

オフラインで動きますか?

オフライン編集には、アプリ、編集エンジン、変換器、必要なフォントや形式のリソースがブラウザにキャッシュされ、保持されている必要があります。一度の訪問や PWA のインストールだけでは保証されません。 リモートファイルの URL には接続が必要です。

最新版を入手するには?

サイトは次回の訪問時に自動で更新されます。古いビルドのままのように見える場合は、強制再読み込み(Ctrl+Shift+R / ⌘⇧R)するか、ブラウザのサイト設定で Service Worker の登録を解除してください。

プライバシー

ドキュメントはどこかにアップロードされますか?

基本的なファイルの読み込み、編集、形式変換はブラウザ内でローカルに実行され、ドキュメントのアップロードは不要です。 内蔵 AI アシスタントは未完成で、公開済みの利用可能な機能ではありません。 埋め込み先のアプリは書き出したファイルを受け取り、独自の方針でアップロードできます。

このページはネットワークから何を読み込みますか?

ページはアプリのコード、エディタのリソース、フォント、Cloudflare Web Analytics のリクエストを読み込みます。リモート URL は追加の通信を行います。埋め込み先や外部のブラウザエージェントには独自のデータ方針があります。

エラー

通知に出るエラーコードの意味は?

  • -85 — ファイルの中身が拡張子と一致していません(例: HTML ページが .xls として保存されている、実体が .doc の .docx など)。名前を変えるか、書き出し直してください。
  • -82 — ファイルを変換できませんでした。壊れている、パスワードで保護されている、あるいはエンジンが対応していない種類の可能性があります。
  • -24 / -25 — エディタのスクリプトの読み込みに失敗しました。多くはネットワークの一時的な問題か、古いキャッシュのビルドです。強制再読み込みしてからもう一度お試しください。
  • 80 — コンバータ内部で書き出しに失敗しました。別の出力形式をお試しください。それでも続く場合は、ファイルの種類と手順を添えて issue を立ててください。

何かおかしいときはどこに報告すればよいですか?

ブラウザとそのバージョン、ファイルの種類、そして——機密でなければ——問題が再現するファイルを添えて、GitHub に issue を立ててください。説明より、最小の再現手順のほうが役に立ちます。

セルフホスト

自分で運用できますか?

はい。静的サイトなので、どの Web サーバーでも動きます: docker run -d -p 8080:80 ghcr.io/ranuts/document:latest、あるいは pnpm run build でビルドして dist/ フォルダーを配信してください。HTTPS や Basic 認証の選択肢は README を、各リリースの変更点は変更履歴をご覧ください。

タブを閉じると何が残りますか?

自動保存が有効な場合、復元用コピーはこのブラウザの IndexedDB に最後の編集または読み込みから 7 日間保持されます。タブを閉じても削除されません。/history でコピーを削除したり自動保存を無効にしたりできます。ブラウザの保存領域は消去や回収の対象になり、未保存の編集は失われる可能性があります。復元機能はファイルの正式な保存の代わりにはなりません。

内蔵 AI アシスタントは利用できますか?

内蔵 AI アシスタントは未完成で、公開済みの利用可能な機能ではありません。 埋め込み先のアプリは書き出したファイルを受け取り、独自の方針でアップロードできます。

ソース: リポジトリの content/ja/help.md · GitHub