意識の高いLISPマシンスマートフォン用の表示で見る意識の高いLISPマシン藤原惟/すかいゆき(@sky_y)の技術用ブログこの広告は、90日以上更新していないブログに表示しています。(まだまだ空欄だらけなので、執筆者も募集しています。)この記事は2部構成の2部目です。意識の高いLISPマシン2日目:実際に試してみた記録(いまここ)今回は、実際にSphinxをインストールし、Markdownで文書が作成できるかどうかを試してみます。元ネタはこのプレゼンです(再掲)。HomebrewでインストールしたPython2を使用します。最近ターミナルをほったらかしていたので、まずHomebrewを整備します。upgradeバージョンを確認。元にインストールしてみます。Sphinxをインストール。recommonmark次はsphinx-quickstartですが、そのままだとエラーになります。Sleepエラーを修正するために、.bashrcまたは.zshrcに下記を追加し、シェルを再起動します。LC_ALL='ja_JP.UTF-8'文書を書いてみるまず、ターミナルを開き、適当なディレクトリを作ります。これを作業ディレクトリにします。続いて、sphinx-quickstartを実行します。ここから対話形式で質問されるので、下記のように答えました。(わかる人は好みで変えてもOKです。linkcheck.source/conf.pyを修正するここでカレントディレクトリを見ると、buildとsourceの二つのディレクトリが出来ています。構造を明示的に指定する必要があります。←これを追加する(拡張子は不要)Markdown文書を作るsourceディレクトリの下に、main.mdというMarkdown文書を適当に作ります。Markdownを使ったドキュメントこれはMarkdownを使ったドキュメントです。ビルドする最後にビルドします。この設定ではmakeコマンドが使えます。引数には形式を指定するのですが、指定できる形式は引数無しでmakeを打つと見ることができます。ここではHTMLを生成してみます。htmlすると、build/htmlの下にHTML文書一式が現れます。build/html/index.htmlと打つと、そのままブラウザで閲覧できます。面倒なのでスクリーンショットだけ示します。indexページ(index.rst)。Markdownで書かれたmainページ(main.md)。基本的にはCommonMarkで使えるものしか使えません。下記を参照してください。SpecまとめSphinxでうまくMarkdown文書を取り込めました。Sphinxを使ったのは初めてですが、なかなか奥の深さを感じさせられるツールです。深掘りしてみたいです。LaTeX)向けのように思います。適材適所で使えたらよいかと思います。最後に、Sphinx-usersメーリングリストの方々に感謝の意を示して、この記事を終わります。(1)はてなブログをはじめよう!sky-yさんは、はてなブログを使っています。ブログを報告するスターをつけました引用をストックしましたストック一覧を見る閉じる引用するにはまずログインしてくださいログイン閉じる引用をストックできませんでした。再度お試しください閉じる限定公開記事のため引用できません。