rst2odt.py 用の stylesheet を作る準備

rst2odt.py の変換結果がイロイロまずい

先日、docutils を使った OOo Writer (.odt ) 形式への変換 を試してからサクっと一ヶ月が経ったわけだけど、あれは実はあのままでは面白くない。というのも

フォントなどのスタイル情報が自分の好みに合わない。

結果として手作業で一つ一つスタイルを合わせ直さないといけないんだとすると、全然省力化になっていない。そもそもこの「マウスを握ってポチポチやらなきゃいけない感」がきらいだからこそ Office がきらいだと言っても過言ではないのに、そこが改善されないままではいくらスタートが reST であってもダメダメである。

スタイルシートを与えて変換する

ではどうしたらいいのかというと、ちゃんと方法がある。help を見ると

$ rst2odt.py --help
Usage
=====
  rst2odt.py [options] [<source> [<destination>]]

Generates OpenDocument/OpenOffice/ODF documents from standalone
reStructuredText sources.  Reads from <source> (default is stdin) and writes
to <destination> (default is stdout).  See
<http://docutils.sf.net/docs/user/config.html> for the full reference.

Options
=======
(snip)
ODF-Specific Options
--------------------
--stylesheet=STYLESHEET
                        Specify a stylesheet.  Default: "/opt/local/Library/Fr
                        ameworks/Python.framework/Versions/2.6/lib/python2.6
                        /site-packages/docutils-0.6-py2.6.egg/docutils/writers
                        /odf_odt/styles.odt"

と書かれているので、

--stylesheet=STYLESHEET

を与えればよいことが分かる。また、このときデフォルトで与えられる stylesheet のファイルが分かる1ので、次にこれを cp して中身を確認してみる。

ODTWriter の stylesheet の中身を見る

最初に引っかかったのが

stylesheet として与えるものが .odt であるということは、これは Writer のファイルそのものであって、テンプレート ( .ott ) ではない

ということだった。というのも、GUI で文書を作るときにはテンプレートを作ってそれが見た目の基準になるのが基本的な流れだから。どうも docutils の ODTWriter の考え方は違うらしい。

話がそれたが、OOo のファイルフォーマットである ODF ( Open Document Format ) は XML でかつ ZIP アーカイブだということは知っていたので、まずは styles.odt を展開してみる。

$ unzip styles.odt -d styles
Archive: styles.odt
extracting: styles/mimetype
inflating: styles/content.xml
inflating: styles/styles.xml  <- コレ
extracting: styles/meta.xml
inflating: styles/Thumbnails/thumbnail.png
inflating: styles/Configurations2/accelerator/current.xml
creating: styles/Configurations2/progressbar/
creating: styles/Configurations2/floater/
creating: styles/Configurations2/popupmenu/
creating: styles/Configurations2/menubar/
creating: styles/Configurations2/toolbar/
creating: styles/Configurations2/images/Bitmaps/
creating: styles/Configurations2/statusbar/
inflating: styles/settings.xml
inflating: styles/META-INF/manifest.xml

もう正解は書いちゃったけど、それっぽい名前のファイルが見つかった。まずは font の設定を変更したいので font 関連の記述のあるファイルを探そう。

$ grep -rl font *
content.xml
settings.xml
styles.xml

※ ここで役に立つのが(実際には同日の作業なんだけど)昨日のエントリとして書いたxml-modeのindentとそれを活かすための改行の挿入である。

content.xml は内容っぽいのであやしいのは settings.xml と styles.xml かな。このうち settings.xml は font の設定はないっぽい。となると styles.xml か。

ということで styles.xml をいじっていけばよいらしいことが分かった。

該当スタイルを見ておく

最初何も考えずに styles.xml をいじり始めて「反映されない!」と騒いでいたんだけど、よくよく見れば当たり前。変換後の文書を注意深く見てみると分かるんだけど、rst2odt.py で生成した文書は通常の「見出し」などの書式ではなく

"rststyle-heading1" のような書式が割り当てられている。

そうか、これをいじるのか。ということは 'rststyle-*' を対象にスタイルを考えていけばいいのか。

とりあえず今日はここまで。

参考

ざっと手順を追ってみたけど、後で調べたらちゃんと資料があった。まぁ当たり前か。

関連エントリ

  1. 上の場所は MacPorts で入れた Python 2.6 の docutils 0.6 の場合 

More

Categories

Tool 日々 Web Biz Net Apple MS ことば News Unix howto Food PHP Movie Edu Community Book Security Text TV Perl Ruby Music Pdoc 生き方 RDoc ViewCVS CVS Rsync Disk Mail FreeBSD Cygwin PDF Photo Zebedee Debian OSX Comic Cron Sysadmin Font Analog iCal Sunbird DNS Linux Wiki Emacs Thunderbird Sitecopy Terminal Drawing tDiary AppleScript Life Money Omni PukiWiki Xen XREA Zsh Screen CASL Firefox Fink zsh haXe Ecmascript PATH_INFO SQLite PEAR Lighttpd FastCGI Subversion au prototype.js jsUnit Apache Trac Template Java Rhino Mochikit Feed Bloglines CSS del.icio.us SBS qwikWeb gettext Ajax JSDoc Rails HTML CHM EPWING NDTP EB IE CLI ck ThinkPad Toy WSH RFC readline rlwrap ImageMagick epeg Frenzy sysprep Ubuntu MeCab DTP ERD DBMS eclipse Eclipse Awk RD Diigo XAMPP RubyGems PHPDoc iCab DOM YAML Camino Geekmonkey w3m Scheme Gauche Lisp JSAN Google VMware DSL SLAX Safari Markdown Textile IRC Jabber Fastladder MacPorts LLSpirit CPAN Mozilla Twitter OpenFL Rswatch ITS NTP GUI Pragger Yapra XML Mobile Git Study JSON VirtualBox Samba Pear Growl Mercurial Rack Capistrano Rake Win RSS Mechanize Sitemaps Android JavaScript Python RTM OOo iPod Yahoo Unicode Github iTunes God SBM friendfeed Friendfeed HokuUn Sinatra TDD Test Project Evernote iPad Geohash Location Map Search Simplenote Image WebKit RSpec Phone CSV WiMAX USB Chrome RubyKaigi RubyKaigi2011 Space CoffeeScript Nokogiri Hpricot Rubygems jQuery Node GTD CI UX Design VCS Kanazawa.rb Kindle Amazon Agile Vagrant Chef Windows Composer Dotenv PaaS Itamae SaaS Docker Swagger Grape WebAPI Microservices OmniAuth HTTP 分析基盤 CDN Terraform IaaS HCL Webpack Vue.js BigQuery Middleman CMS AWS PNG Laravel Selenium OAuth OpenAPI GitHub UML GCP TypeScript SQL Hanami Develop Document Jekyll