【ITニュース解説】Run MkDocs on iPad with iSH and Browse It Locally 🎉

iPadをまるで小さなコンピューターサーバーのように使いこなし、ドキュメントを作成・公開できる画期的な方法がある。これは、システムエンジニアを目指す初心者にとって、手軽に開発環境の一端を体験できる良い機会となるだろう。外出先でノートパソコンがなくても、iPadひとつで自分のアイデアを形にし、それをウェブサイトのように閲覧できるという点が大きな魅力だ。

この仕組みの核となるのは、iSHというアプリとMkDocsというツールである。まずiSHについて説明する。iSHは、iPad上で動作する仮想的なLinux環境を提供するアプリだ。Linuxは、サーバーや多くの開発現場で使われているオペレーティングシステムであり、iSHを使うことでiPadの中に、まるで別のコンピューターがあるかのようにLinuxのコマンドを実行できる。App Storeから無料で入手でき、内部では軽量なAlpine Linuxが動いているため、iPadの限られたリソースでも快適に動作する。これは、物理的なサーバーを持たずに、手元のデバイスで開発環境を試す第一歩として非常に価値がある。

次にMkDocsだ。MkDocsは、Markdownというシンプルな記述形式で書かれたテキストファイルから、簡単に静的なWebサイト形式のドキュメントを生成できるツールである。Markdownは、プログラムのソースコードや技術文書、ブログ記事などで広く使われており、少ない記号で文字の装飾や見出しの作成ができるため、覚えやすい。MkDocsを使えば、Markdownで書いた説明書や技術メモが、数クリックで見た目の整ったウェブページになり、インターネットブラウザで閲覧できるようになる。システム開発において、ドキュメントの作成と管理は非常に重要であり、MkDocsはその作業を効率化する強力なツールの一つと言える。

なぜこの方法が便利なのか。第一に、場所を選ばずにドキュメントの作成とプレビューができる点が挙げられる。ノートパソコンを持ち歩かなくても、iPadがあれば電車の中やカフェなど、どこでも気軽にドキュメントを書き、実際にどのように表示されるかを確認できる。第二に、iPadを自己完結型の開発・ドキュメント環境に変えられることだ。外部のサーバーや特別な設備を用意する必要がなく、iPad一台でドキュメントの作成から公開、閲覧までが完結する。まるでインターネット上に公開されているウェブサイトのように、ブラウザで自分のドキュメントサイトを閲覧できるが、実際にはすべてiPadの内部で処理されているため、インターネット接続がない環境でも作業が可能となる。

具体的な手順を見ていこう。まず、App Storeから「iSH Shell」アプリをiPadにインストールする。これがLinux環境の土台となる。

次に、iSHの中でPythonというプログラミング言語と、その開発に必要なツールをインストールする。MkDocsはPythonで書かれているため、その実行環境を整える必要がある。iSHを起動したら、まずapk updateコマンドでパッケージリストを最新の状態にし、次にapk add python3 py3-pip build-base python3-dev libffi-dev openssl-devというコマンドを実行する。apkはAlpine Linuxでソフトウェアを管理するためのコマンドで、これでPython3本体、Pythonのパッケージ管理ツールであるpip、そしてプログラムをコンパイルするために必要なツール群をまとめてインストールする。その後、pip install --upgrade pip setuptools wheelと入力し、pip自体と関連ツールを最新の状態に更新する。

そして、いよいよMkDocs本体をインストールする。先ほどインストールしたpipを使って、pip install mkdocs mkdocs-materialと入力する。mkdocs-materialは、MkDocsで生成されるドキュメントサイトの見栄えを良くするためのテーマ（デザインテンプレート）の一つで、美しく機能的なサイトを簡単に作れるため多くのユーザーに利用されている。インストールが完了したら、mkdocs --versionと入力して、正しくインストールされ、バージョン情報が表示されるか確認できる。

次に、新しいMkDocsプロジェクトを作成する。これは、ドキュメントサイトの元となるファイルやフォルダの骨組みを作る作業だ。mkdocs new mydocsというコマンドを実行すると、「mydocs」という名前の新しいフォルダが作成され、その中に初期設定ファイルやサンプルページが生成される。作成されたプロジェクトフォルダに移動するため、cd mydocsと入力する。

その後、作成したドキュメントサイトをiPadの内部で公開する（ローカルサーバーを起動する）。これが「魔法の部分」と記事では表現されている。mkdocs serve -a 127.0.0.1:8000というコマンドを実行する。mkdocs serveは、開発用のWebサーバーを起動するコマンドだ。-a 127.0.0.1:8000という部分が重要で、127.0.0.1は「ローカルホスト」と呼ばれる特別なIPアドレスで、これは「自分自身のデバイス」を意味する。つまり、iPad自身からのみアクセス可能な場所だ。:8000はポート番号で、特定のサービスを識別するための番号である。このコマンドを実行すると、iPadのiSH内でWebサーバーが立ち上がり、生成されたドキュメントサイトを外部からアクセスできる状態になる。

最後に、実際にiPadのブラウザでサイトを閲覧する段階だ。iSHアプリを起動したまま、iPadのChromeやSafariといったWebブラウザを開き、アドレスバーにhttp://127.0.0.1:8000/と入力してアクセスする。すると、先ほどMkDocsで作成し、iSH内で公開したドキュメントサイトがブラウザに表示される。これは、インターネット上のWebサイトを見ているように感じるかもしれないが、実際にはすべてiPadの内部で完結しているため、非常に高速に表示され、インターネット接続も不要だ。

ただし、一点注意が必要である。iSHアプリを完全にバックグラウンドに送ってしまうと、iOSの省電力機能によってiSH内のプロセス（MkDocsのWebサーバーなど）が一時停止されてしまう。そのため、ドキュメントサイトを閲覧中は、iSHアプリをフォアグラウンドで動かすか、Split View（画面分割）機能を使ってブラウザと並べて表示しておくのが賢明だ。

この一連の作業は、iSHというアプリがいかに強力であるかを示している。MkDocsと組み合わせることで、iPadが持ち運び可能なドキュメント作成ラボに変身する。Markdown形式でドキュメントを編集し、変更を即座に反映させて、リアルタイムでブラウザでプレビューできる。これらすべてが、一台のiPadだけで実現できるのだ。システムエンジニアを目指す上で、このような手軽な環境でドキュメント作成や簡単なWebサイト構築を体験することは、技術への理解を深める非常に良い経験となるだろう。Pythonをベースとした他の開発ツールも、同様の方法でiPad上で動かせる可能性があり、iPadの活用範囲を大きく広げるヒントとなる。