各 OS での「関連付けされたアプリケーションで開く」方法

• Windows : start
• Mac : open
• Linux : xdg-open or gnome-open

マルチプラットフォームで「関連付けされたアプリケーションで開く」をやりたい場合は、 Windows, Mac は上記の通り、 Linux は xdg-open をデフォルトとしつつ、コマンドを設定できるようにするのが良いのかな？

参考文献

• ターミナルからファイルを開く
• xdg-open - ArchWiki

Sphinx を実行したら、 ERROR: non-ASCII filename not supported on this filesystem encoding 'ANSI_X3.4-1968', skipped. というエラーが出た

• 結論
• 作業記録

結論

apt で locales と locales-all をインストールし、環境変数 LANG に ja_JP.UTF-8 を設定。以上。

作業記録

日本語ディレクトリを作ったら、以下のエラーが発生した。

sphinx-build -b html -d build/doctrees   source build/html
Running Sphinx v1.4.9
loading translations [ja]... not available for built-in messages
loading pickled environment... done
building [mo]: targets for 0 po files that are out of date
building [html]: targets for 0 source files that are out of date
はじめに.rst:: ERROR: non-ASCII filename not supported on this filesystem encoding 'ANSI_X3.4-1968', skipped.
...(略)
/work/source/index.rst:14: WARNING: toctree contains reference to nonexisting document u'\u306f\u3058\u3081\u306b'
...(略)

日本語を含むパスでエラーが起きて、対象のディレクトリを見つけられず、 toctree でそのリンクがが作成されない感じ。

エラーメッセージで検索し、下記箇所が問題の処理だというのがわかった。

• sphinx/osutil.py

いろいろ検索したら、多言語対応に必要なパッケージが無いのが原因だったことがわかった。

• Python 3の各種エンコーディングについて - Qiita : http://qiita.com/methane/items/6e294ef5a1fad4afa843
• docker公式イメージと文字コード - Qiita : http://qiita.com/masarakki/items/0bdcefce99da6e8cbdac

そんなわけなので、 Dockerfile に下記 2 行を追加した。

RUN apt-get -y install locales locales-all && apt-get -y clean
ENV LANG=ja_JP.UTF-8

最終的に下記 Dockerfile ができた。

• mikoto2000/sphinx - Docker Hub : https://hub.docker.com/r/mikoto2000/sphinx/

以上。

Ubuntu 17.04 に Sphinx + textlint + prh の環境を整える

• 目的
• 成果物

目的

前回作った Ubuntu の Docker イメージ をもとに、 sphinx と textlint, prh の環境を整える。

成果物

で、作った Dockerfile がこれ。 オフィシャルの ubuntu:zesty イメージを基にする場合は「apt ミラー設定」は不要。

FROM myubuntu:zesty

# apt ミラー設定
RUN echo "deb http://jp.archive.ubuntu.com/ubuntu/ zesty main restricted universe multiverse" > /etc/apt/sources.list
RUN echo "deb http://jp.archive.ubuntu.com/ubuntu/ zesty-security main restricted universe multiverse" >> /etc/apt/sources.list

# ベースのアップグレード
RUN apt-get -y update
RUN apt-get -y upgrade && apt-get -y clean

# sphinx 環境構築
RUN apt-get -y install make && apt-get -y clean
RUN apt-get -y install sphinx-common && apt-get -y clean

# nodejs 環境構築
RUN apt-get -y install curl && apt-get -y clean
RUN apt-get -y install gnupg1 gnupg2 && apt-get -y clean
RUN curl -sL https://deb.nodesource.com/setup_6.x | bash -
RUN apt-get -y install -y nodejs && apt-get -y clean

# textlint 環境構築
RUN npm install -g textlint
RUN npm install -g prh
RUN npm install -g textlint-rule-prh

# textlint を rst 対応させるためのもの
RUN apt-get -y install -y python-pip && apt-get -y clean
RUN pip install docutils-ast-writer
RUN npm install -g textlint-plugin-rst

# textlint 結果可視化するための環境構築
RUN apt-get -y install lcov && apt-get -y clean
RUN npm install -g textlint-formatter-lcov

以上。