Markdownと参考文献

Common Lispはこの本[1]で学びました。という話がしたいわけではなくて、Markdownで書いているときに「参考文献ってどうやって書くんだっけ？」と思って調べたことの備忘録です。

一般的に参考文献は脚注を付けるバンクーバー方式か、括弧で著者名と出版年を書くハーバード方式の2つがあるみたいです。[2]後者は文系の書き方かな？ネットだと前者が多いですかね？ということでバンクーバー方式を採用しましょう。

Markdownでの脚注の記法は

文章[^1]

[^1]: 脚注

のように書くみたいですね。

VSCodeのMarkdown All in Oneはまだ対応していないみたいですけど。

でも、書きたいのは脚注じゃなくて参考文献です。脚注と参考文献を分けない派もあるみたいですけど、見やすくするために分けましょう。Wikipediaなんかはページによってまちまちなんですが、脚注で書名と具体的なページを書いて、書名が参考文献へのリンクになっているのが多いですかね？これが便利そうなので採用します。別に誰かに指定されているわけではないので、見やすそうなのを採用していきます。

そういえば、脚注が補足なのか、文献へのリンクなのか跳ぶ前にわかると便利そうですが、それは後で考えましょう。

参考文献の書き方は SISTスタイル、MLAスタイル、APAスタイルとあるみたいですが[2]、SISTスタイルに『』を付けたものが見やすそうなので採用です。

おれおれマークダウンなのでHTMLに展開しなければならないのですが、シンプルに

[^1]を<a href="#footnote_1"><sup>[1]</sup></a>
[^1]:を<a id="footnote_1">[1]</a>

みたいな感じでしょうか？

脚注の書き方をぐぐっていて気が付いたのですが、PandocというHaskellで書かれたツールがあるんですね。Pandoc拡張Markdownというなかなかに強力そうな書式で書けるみたいです。拡張性もあるみたいですけど、きれいに書きたいわけではないので、泥臭くてもなんでもできるRubyで書いておいたほうがいいのかと思っています。

ブログを書き終わってからおれおれマークダウンの実装をしているんですが、

[^3]: [ただの大括弧][link](#link)[^2]

\[\text{MathJax test}\frac{a}{b}\]

というのの解釈がめんどくさかったです。強引に書きましたけど。

    elsif md = line.match(/^\[\^([^\]]*)\]:(.*)/) then
        line = "<li><a id='footnote_#{md[1]}'>[#{md[1]}]</a>:" << parse_line(md[2]) << "</li>"

  line.gsub!(/\[([^\]]*)\]\(([^\)]*)\)/) {
    "<a href='#{$2}'>#{$1}</a>"
  }
  line.gsub!(/\[\^([^\]]*)\]/) {
    "<a href='#footnote_#{$1}'><sup>[#{$1}]</sup></a>"
  }

で、

# 脚注
[^1]: [『LISP 1』](#LISP1)と[『LISP Ⅱ』](#LISP2)  
[^2]: [『引用・参考文献の書き方』](#ritsumei)  
[^3]: [ただの大括弧][link](#link)[^2]

\[\text{MathJax test}\frac{a}{b}\]

# 参考文献
- <a id="LISP1">P.H. ウィンストン (著)、B.K.P. ホーン (著)、白井 良明 (翻訳)、安部 憲広 (翻訳)、井田 昌之 (翻訳)『LISP(Ⅰ)(原書第3版)』[第3版]培風館、1991年</a>
- <a id="LISP2">P.H. ウィンストン (著)、B.K.P. ホーン (著)、白井 良明 (翻訳)、安部 憲広 (翻訳)、井田 昌之 (翻訳)『LISP(Ⅱ)(原書第3版)』[第3版]培風館、1991年</a>
- <a id="ritsumei">立命館大学図書館 レファレンス係『引用・参考文献の書き方』2022-3、https://www.ritsumei.ac.jp/lib/pub/d08/010/14_quote.pdf</a>

が以下のようになって完成…していると思う。

ついでにAmazonのテスト。

脚注

\[\text{MathJax test}\frac{a}{b}\]

参考文献

Amazon

コメント

コメントを投稿

このブログの人気の投稿

五十音配列付き新下駄配列

イメージ
keyboard layout editorデビューしました。ファイルが複数になると管理がめんどうなので、このブログの内容はSVGファイルに直接書いてますが、これでいいんだっけ？まあ、消えなければ後からなんとでもなるからいいか。 と思ったら、SVGは日本語に対応していないみたいです。しくしく。 レイアウトは新下駄配列に覚えやすい五十音配列を加えたものです。アルファベット自体をいじってますが、qtypをちょっと動かしただけです。bntyを親指で押すシステムなんですが、けっこう快適です。ErgoDox EZだと斜めになっているキーが親指に当たるので取ってしまっています。アルファベットの長押しに制御キーやレイヤーキーを割り当ててしまえば30%で十分なんですね。ほとんど手首を動かさずに入力できます。 日本語配列は新下駄配列の拗音以外はそのままなので、覚え直すことなく使えます。五十音部分は左手で行を指定して、右手で段か拗音を指定する方式です。新下駄配列で使用しているsdklはそのまま残してあるのでさ行、た行がありませんが、それは新下駄の方を使ってください。拗音は新下駄のものをそのまま使うこともできたのですが、左手で行を指定する方式なのを活かして、右手で拗音を指定する方式にしました。各行に拗音とくっつくのはひとつしかないんですね。不思議な感じです。 欠点はロールオーバーミスが起こりまくることです。「うんち」と入力しようとして「にち」になるようなことがよく起こります。新下駄配列でもsdklioがからむと起こるのですが、それ以外にもシフトキーを増やしたので大幅に起こりやすくなっています。そういう配列なのでそこはあきらめてください。スピードを犠牲にして脳の負荷を抑えた配列です。ただ、ローマ字テーブルからfj同時押しで「に」の項目を消してしまえばそうはならないので、いろいろカスタマイズできるかもしれません。この配列でスピードを目指すならステノワードのような方向になるでしょう。脳の負荷が増えてしまいますが。 良い点は、左手で行を指定する方式なので数字行にはみ出していたみゃ行等を30%の範囲に取り込めたことでしょうか。もう一つ、頻度の低い文字は五十音の方を使うことにすれば、空いた所にいろいろ突っ込めるところでしょうか。かなり気に入ってます。 ∨ Source mar...
続きを読む

WSLでの親指シフトはどうやらMozcで実現可能と気がつくまで

WindowsではAutoHotKeyを使って疑似親指シフトで日本語を入力しています。もともとかな打ちだったんですが、キーボードをErgoDox EZに変えたら「ろ」とかのキーが足りなくなって、どうしようか悩んで親指シフトを見つけてきました。疑似なのは同時押しではなくて、親指でファンクションキーを押しながらアルファベットキーを押すことで出しているからです。AutoHotKeyを使って同時押しを実現しているものがあるのは知っていますが、とりあえずNICOLA配列を試しつつ今まで引っ張ってきた感じです。 Windowsではそれで満足していたのですが、WSLを使うようになって困りました。AutoHotKey(以下AHK)ではIMEの状態を取ってきてオンの場合には出力を変えているのですが、WSLだとAutoHotKeyからMozcの情報を取ってこられる気がしません。WSL側で検知してWindows側から読める位置にファイルを置くような、トリッキーな方法を使えばできなくはないような気もしますが、そこまでしてAHKに頼るのも変な感じです。 ということで、WSL側で親指シフトを使えるようにしようとぐぐって出てきたのは oyainput というやつでした。しかし、これがWSLでは動かない。エラーコードから察するに、 /proc/bus/input/devices が空なのでキーボードの情報が取れないのでだめみたいです。まあ、WSLですし。 しかたがないので、今度はWSLのEmacsでWindows側のIMEが使えるという「 emacs-mozc を動かすための設定（WSL 設定編） 」のmozc_emacs_helperというのを試してみました。で、苦労して動かしてみたものの、Windows側の辞書を使って変換はしているようですが、AHKがIMEの状態を把握できないので親指シフトモードに切り替わらないのは同じでした。残念。 いったんは諦めてMinGW版のEmacsを使うことにしたのですが、ぐぐってみたら「 [Question] Possible to (properly) implement simultaneous (custom) Kana-input layout? #512 」というMozcに新下駄配列を実装する話が出てきました。 新下駄配列は知らなかったのでぐぐ...
続きを読む

親指シフト新下駄配列の可能性

Google日本語入力の「シフトキーでの入力切り替え」をオフにして、ローマ字テーブルに大文字で登録すると、登録されたとおりに出力されます。当たり前ですが。これで「L」に「l」とは別に「じ」や「しかし、」や「𝕏」を割り当てることができます。 NICOLAなどの親指シフトとは違って、たんに大文字かどうかを見ているだけなのでシフトキーの左右を区別はできませんが、いろいろな使い方が考えられそうです。例えば、「X」に「𝕏」を割り当てるとか、「A」に「∀」とか。「L」に「しかし、」とかの接続詞を割り当てて入力時間の短縮もできるかもしれません。「L」に「じ」を割り当てて、「じ」に割り当てられている場所に別の文字なども考えられそうです。左右を混ぜて、シフトキーを押している間だけ全く別のマップでアルペジオとかも考えられます。覚えるのが大変ですけど。数字キーに割り当てられている文字をアルファベットに割り当てれば40%キーボードでも3点押しなしに入力することもできます。 このように、いろいろな可能性がありますが、実はまだ使っていません。まだ新下駄配列に慣れていないので、それどころじゃないんですよね。まずは新下駄配列に慣れて、その中で困ったことが起きたら解決に使う感じかな？
続きを読む