ドキュメント作成システムSphinxが便利

WWDC直前ですが,ドキュメント作成のお話を。

最近知ったのですが,1つのプレーンテキスト(reST)からPDF, html, ePub, Wordのドキュメントを生成するシステムSphinxが便利そうで,試行錯誤しています。

SphinxはPythonのドキュメント作成のための作られたシステムです。以下のリンクでSphinxのことがよく分かります。

Sphinxユーザー会

ドキュメントを作りたくなってしまう魔法のツールSphinx

Pythonのドキュメントを作れるシステムなので,

  • コードハイライトがきれい。対応する言語も多い。
  • 数式はTeXで処理するのできれい。
  • プレーンテキストで書くので,Gitなどでバージョン管理可能。
  • Python環境があれば,すぐにインストールできる。
  • 関連するドキュメントが日本語化されている。

などいろいろいいところがあります。

reSTはreStructuredTextで,マークアップ言語の1種です。世間ではMarkdownのほうが知られていますが,似たような記法です。=, -, ^などで囲めばタイトルになり,+を頭につけるだけで箇条書きになるので,読みやすい文章がかけます。GithubやQiitaの原稿がMarkdownなので,Markdownを使うことが多いかと思います。その場合はPandocで変換できるので,reSTに変換することができるので,特に問題ないです。

htmlでざっくりかいて,確認して,完成版をPDFに変換するということができます。Wordで作文するのに飽きている人にはぜひおすすめします。

プライベートクラウドownCloudがいい感じ

2013年は一度も書かずに2014年をむかえてしまいました.それなりにネタになりそうなことはあるんですが,仕事用のドキュメントを書くのに手一杯になってました.

今回は職場で使えるDropbox代替になるものはないかと探したら,ownCloudが良さそうという話です.

職場で複数人(10人弱)間でファイル同期できたらいいなとなって,いろいろ調べました.Dropbox,Google Driveはとっても便利ですが,他所様のサーバーにデータを置きたくない.LAN内だけで使えるものはないかとおもって,Lifehackerの記事 を参考にして,BitTorrent SyncSparkleShare を使ってみましたが履歴管理や変更のコンフリクト処理がいまいちでした.Dropboxはちゃんとできてます.

それでさらに調べて候補になったのがownCloud.このへんを参考にしました.

SlideShare

MoonGift

簡単にいうとオープンソースのクラウド環境ソフトです.Dropboxみたいなファイル同期,バージョン管理,ファイル共有ができます.Windows, Mac, Linux用のファイル同期クライエントがあり,有料版でiPhone, Androidアプリもあります.さらにカレンダーとドキュメントも共有できます.DropboxとGoogleカレンダーのプライベートが作れるようなもんです.詳細は公式HPを見て下さい.

手始めに家にあるFedoraにownCloudをいれてみました.LAMP(Linux, Apache, MySQL, PHP)環境が整っていれば簡単にセットアップできます.

Apacheとか入れてなかったので,yumでちまちまインストールしました.手順はここを参照しました.Apacheの設定で若干はまりました.Fedora18のファイアウォールを切らないとLAN内の他のマシンからアクセスできない問題が発生して,これに気づくのに時間かかりました.

ownCloudは公式ページ にLinuxのディストリビューション別にyumのリポジトリの設定方法があるので,これを参考にして,yumでインストールしました.ownCloudの設定は参考になるサイトがたくさんあります.今回は以下のサイトを参考にしました.

自分だけのDropBox? owncloudでファイル共有

[Nexus7活用術]その1. ownCloudで自分専用クラウドを手に入れる手順

Owncloudのインストール

ownCloudをyumでインストールしたあとだと,いきなり設定にはいります.ユーザー設定とSQLのデータベースを指定したら,ほぼ終わり.Mac用のファイル同期クライエントもいい感じです.過去のバージョンに戻すのも簡単です.使いがってはDropboxとほぼ一緒だと思います.

最初のサーバー設定がややこしいですが,それを乗り越えたら超便利な環境が手に入ります.

iPad用にマイクロソフトのBluetoothキーボード買ってみた

iPhone5のテザリングが使えるようになりiPadを外で使うことが増えました.Evernoteの文章の編集とか,ターミナル操作で家のiMacを操作したり,いろいろあるわけですが,ソフトウェアキーボードがやっぱり慣れない.というわけで,Bluetoothキーボードを買ってしまいました.

悩んで悩んで結局かったのは,マイクロソフトのWindows8用ボタンをもっていて,各種タブレットに対応しているという「Wedge Mobile Keyboard for Business Bluetooth U7R-00022」です.ビジネス用ではないU6R-00022というキーボードもあるのですが,モノ的には同じようで,ビジネス版が2000円ほど安いので,こっちにしました.ちなみにAmazonで4600円ほど.

実際にiPadで使った感想.ちなみにうちのiPadはiPad2です.メールやEvernoteの文章を編集するには十分使えます.同じキーが連続で入力される(チャタリングする)ことはないです.Apple Wireless Keyboardに比べると若干小さいですが,キーが打ちにくいことも特にないです.接続がぶちぶち切れることも無いです.このへんは安いキーボードとはちがって,しっかりしてます.

カバーと本体.カバーを外すと電源が自動ではいります.かぶせると電源オフ.このカバーはさらにiPadの台になります.しっかりしてます.キー操作でも電源オン・オフできます.Fn+ESCキーの長押しです.
IMG_4639.JPG

キートップ.JIS配列のWindowsキーボードです.あとで書きますが,このJIS配列が結局厄介なことに...

IMG_4640.JPG

AppleのWireless Keyboardと比べてみたところ.小さいです.持ち運ぶならこのくらいが限界だと思います.
IMG_4642.JPG

基本的には使えるのが分かったのですが,困ったこともありました.JIS配列なのにUS配列のキーボードとして認識されることです.Amazonで探してる時もUS配列がどうのこうのっていう書き込みは見てはいましたが,完全に無視してました.iPadってJIS配列のキーボードのほとんどをUS配列として認識するんですね...盲点でした.Apple WirelessキーボードのJIS配列版はちゃんとJIS配列キーボードとして認識するので,他のもちゃんと認識してくれてもいいような気はしますが.

マイクロソフトキーボードでシフト+数字を1から打っていくと以下のようになります.
!@#$%^&*()_+
見事に2の部分に@が来てます.
Apple Wirelessキーボードはというと
!”#$%&'()0=~|
ちゃんとJIS配列.

これで一番困ってるのが,円マーク¥とパイプラインの|がどうやってもBluetoothキーボードから入力できないことです.個人的には円マークはどうでもいいですが,パイプラインはないとターミナル処理のときに困ります.仕方ないので,ユーザー辞書にパイプラインを登録して,メモかEvernoteに出力したのをコピペして使うことにしました.そこまでしょっちゅうターミナル使うわけじゃないので,これで十分ですが,入力できないキーがあるのは困りもんです.

総合的にみて,このWedge Mobile Keyboardはモバイル用のキーボードとして,打ち心地とか完成度は高いと思います.iPadでも細かいことを気にしない場合はちゃんと使えます.キー配置の違いもそこまで困る問題でもないですから.

一応,iPadでちゃんと使うならiPad専用のキーボードを使うのもありかなとは思います.でも打ち心地が悪いとか,打ち間違いが連発するようなキーボードよりは,多少打つのが面倒なキーがあっても,ちゃんと打てるキーボードがいいと思います.

iPhone5のテザリング@常磐線での状況

au iPhone5のテザリングをこきつかってみました.上野ー水戸間の常磐線で主に使ってみました.往復ともに特急の新型車両(ピンクと白の車両)で,各席にコンセントがあります.

主に自宅のiMacにVNC接続して,画面共有して,VMで動いているFedoraを動かす,ということをしました.常磐線乗ってる間はほとんどLTE回線にはつながらず,3G回線でした.途中きれて再接続になることも数回起こりましたが,十分実用的だと思いました.LTEにつながるならもっと速いはずなので,かなり使えます.

ちなみに往復で2時間強接続して,受信が110MBほどでした.送受信合わせて120MBほど(今朝統計情報リセットしました).テザリングでこきつかっても以外に少ないです.1ヶ月で帯域制限かかるのが確か7GBからなので,まだまだ行けます.2ヶ月に一回くらい出張する人にちょうどいいかんじです.

iPhoneの電源が心配だったので,MacBookにUSBで有線接続しました.電源ないとこで使うのは若干不安です.

東京は上野の周りをうろうろしましたが,都内だからLTEはいりまくるわけでもないんですね.大学の奥のほうにはいったりすると未だ3Gにしかつながらない,という感じでした.どんどん広がってはいくんでしょうが.

IMG_4597.PNG