2010-12-12 29 views
4

問題:reStructuredTextを使って "平行テキスト"を書こうとしています。 「平行テキスト」とは、テキストが2つの列にある、フィクションの注釈付き作品のようなものを意味します。左の列には本文が、右の列には注釈が含まれています。私はsphinxを使ってHTMLとLatexのドキュメントを生成します。"平行テキスト"を書くためのスフィンクス

私は、次の要件があります。上記のように

  1. を、私は2つの列、本文用と注釈のための1つのテキストをタイプセットすることができるはずです。
  2. 注釈は「文章レベル」でもかまいません。また、必ずしも「段落レベル」であるとは限りません。つまり、段落内のさまざまな文章や段落全体に注釈を付けることができるようにしたいのです。
  3. すべてのアノテーションがオフになっているので、出力HTMLとラテックスにメインテキストのみが含まれるようにすることは素晴らしいことです。この場合、私は単なるコラムではなく、媒体の「不動産」全体を使用できるようにしたいと考えています。
  4. 可能であれば、「注釈のリスト」機能を持つことは非常にうれしいでしょう。

私はreStructuredTextとSphinxにはかなり新しいですが、Pythonでかなりの経験があります。私は自分がしたいことをする方法についていくつかのアイデアを探しています。私はreStructuredTextとSphinx拡張を書くことについて読んできました。だから、Sphinxへの拡張を書くことは疑問ではありません。

これまで誰かが似たようなことをしたことはありますか?

ありがとうございます!

+1

テーブルを使用できますか? http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#tables 次に、テーブルのセル境界とセルの余白を変更して、必要なものを得ることができます。カスタマイズされたCSSファイルのいくつかの並べ替えを行う必要があります。 –

+0

ロス、それは興味深い考えです。私はそれを試みます。ありがとう! –

答えて

2

これらは脚注と非常によく似ていますか?私は見てみることをお勧めしますhttp://ignorethecode.net/blog/2010/04/20/footnotes/

あなたの目的に合っていれば、それらを統合することはそれほど難しいことではありません。スフィンクスは特別なクラスで脚注を出力します。お好みのjqueryのCSSセレクタで

$( "[REL = '脚注']")コードで

を交換すると、あなたが望む何を与える必要があります。

+0

私はこの考えが好きです。 1つの問題は、注釈の*ロット*があるので、メインテキストには脚注がたくさんあることです。私はまた、文脈ですべての注釈を見ることができるようにしたい。 'sidebar'指示文はおそらく私の必要なものですが、問題はサイドバーが浮動していることです。したがって、メインテキストと目に見える形で関連付けられることは保証されません。ありがとう! –

+0

しかし、脚注と注釈の間のリンクは、おそらく十分な結束性を提供します。さらに、固定2列アプローチでは、テキストと注釈の量が等しくなく、比例していなくても、すべての注釈が可視である場合でも問題はあります。 JavaScriptを使用して注釈を表示できるようにすると便利です。 – tychoish

関連する問題