Emacsのorg-modeで論文を書く(その5:htmlへのexportの際のフォントの色の変更,ハイライトなど)(12月19日追記)

学会発表や論文作成にあたっては,当然のことながら,その分野の他の研究者の論文を読んでまとめるなどの作業を行う.そこで,論文の要旨などをorg-modeにざっとまとめておくと,pdfにもhtmlにもtextにもexport出来て便利である.pdfは印刷に向いているが,htmlは多くの論文をいっぺんに見るのに向いており,また,compileの時間もpdfより圧倒的に速い.また,色を変えたり,ハイライトしたりするのもhtmlなら容易である.そこで,今回は,org-modeからhtmlへexportする際の有用な小技について書いてみたい.

Table of Contents

Org Macros

フォントの色を変更する方法はいろいろあるが,ハイライトや背景の色の変更までできるこの Org Macrosが一番便利である.内容は,org-modeの便利なマクロ集である.リンク先からダウンロードして,適当なところに保存し,解凍しておく.ここでは,/Users/taipapa/hoge/fuga/org-macros.setupに置くことにする.使い方は簡単で上記のwebsiteに書いてあるとおり,各org fileの先頭に以下のように記述してorg-macros.setupの場所を教えてやれば良い.

#+INCLUDE: /Users/taipapa/hoge/fuga/org-macros.setup

これだけである.

  • 注意事項としては,このブログはox-hugoで書いているが,ox-hugoの場合は文書の先頭に上記を書いても効かない.各ポストのpropertyのあとに書いておけば効く.各ポストごとに設定するようになっているらしい.....(全国15人?ぐらいの人にしか意味のない注意書きである)

上記に関しては,ox-hugoの作者であるKaushal Modi氏から以下のような指摘を頂いた.(12月19日追記)

Can you try using #+setupfile instead of #+include? As an example, here is my blog Org source that I export using ox-hugo ( https://gitlab.com/kaushalm… ), and here is the setup file tha t I “include” using the more appropriate #+setupfile ( https://gitlab.com/kaushalm… ).

As you see, I use a lot of Org macros, and they all work in my “one post per subtree” flow.

ということで,ox-hugoの場合は,以下のように文書の先頭に書いておけば,one-post per subtreeの投稿全てにorg-macroが効くことを確認した.

#+setupfile: /Users/taipapa/hoge/fuga/org-macros.setup

こんなブログにまで目を通してコメントしてくれるのには驚いた.親切な方である.日本語が読める人なのかとも思ったが,どうやらGoogleの翻訳を利用されているようだ.このページだと,A Perfect Autumn Dayに行くと翻訳版を見ることができる.その翻訳レベルにも今更ながら感心した...

  • 残念ながら,LaTeXへのexportでは,この方法による色の変更などは(現在のところ)効かない.

いくつか使い方の例をあげておく

{{{color(blue, 青くなるかな?)}}}
*{{{color(blue, ボールドで青くなるかな?)}}}*
{{{highlight(yellow, 黄色にハイライトされるかな?)}}}
*{{{highlight(yellow, 黄色にハイライトされて文字はボールドになるかな?)}}}*
{{{bgcolor(cyan, 背景がシアンになるかな?)}}}
*{{{bgcolor(cyan, 背景がシアンになって文字はボールドになるかな?)}}}*

これが以下のように表示される.

  • 青くなるかな?
  • ボールドで青くなるかな?
  • 黄色にハイライトされるかな?
  • 黄色にハイライトされて文字はボールドになるかな?
  • 背景がシアンになるかな?
  • 背景がシアンになって文字はボールドになるかな?

上記以外にも多くのマクロが含まれており,そちらも人によっては有用かもしれない.少しだけ例をあげておく.以下はパネルの例.

{{{begin_panel}}} Panel example This is a formatted block of text… {{{end_panel}}}

これが,

Panel example This is a formatted block of text…

となる.マニュアルでは以下の使い方を薦めている.

#+begin_panel
*Panel example* \\
This is a formatted block of text...
#+end_panel

Panel example
This is a formatted block of text…

なお,org-modeのマクロ自体に関しては,org-modeのマニュアルの 12.5 Macro replacement を参考にしていただきたい.

Exporting org-mode to HTML: In-place coloring

フォントの色を変える別の方法である.リンク先にある通り,

     この文章は, *@@html:<font color = "blue">@@青のボールド@@html:</font>@@*になって欲しい!

これが以下のように表示される.
この文章は, 青のボールド になって欲しい!

  • org-modeのマニュアルの 12.9.5 Quoting HTML tags も参考のこと

こちらは設定を必要としないが,やはり,最初に説明したマクロの方がいろいろ出来て便利である.

次回は,htmlをexportする際のCSSについてまとめてみたい.

Avatar
taipapa
本人ではありません (^^)

Related

Next
Previous
comments powered by Disqus