問題タブ [restructuredtext]

私はpythondocutilsとrst2html.pyスクリプトを使用して、再構築されたテキストをhtmlに変換しています。

このような行を変換したい：

このようなものに：

しかし、代わりに私はこれを取得します（パス内のスペースは削除されます）：

リンクの空白を保持するにはどうすればよいですか？

Galleriaのドキュメントなど、ドキュメントがある場合、make htmlコマンドを実行すると各ページにカスタムフッターが追加されるように設定するにはどうすればよいですか？

conf.pyのラテックスプリアンブルセクションをPDF形式で出力する場合、それを使用できる可能性があることがわかりました。

ありがとう！

HTML/Text から ReST へのコンバーターに関する提案はありますか?

さまざまなオプションを精査しましたが、確実な解決策は見つかりませんでした。(注: Pandoc は見つかりましたが、Haskell をインストールする必要はありません)。

内部ハイパーリンク ターゲットを定義した場合、リンク タイトルとして任意のテキストを使用してリンクするにはどうすればよいですか?

例えば：

「短い参照」ターゲットを「非常に長い内部ターゲット」にするにはどうすればよいですか?

編集：別の例：

「ウィジェット」（単数形）の見出しに「ウィジェット」（複数形）のリンクを作成するにはどうすればよいですか?

（もちろん、これを使用して実行できることは理解して`widget`_\sいます…しかし、それは一般的な問題を解決しません）

拡張子が.rst. docutilsbuildhtml.pyは、拡張子.txtが . これは非常に迷惑です。Github に.txtファイルを RST または buildhtml として認識させてファイルを認識させる方法はあり.rstますか?

先頭と末尾のスペースなしでハイパーリンクを作成することは可能ですか？以下は機能しません。

私が尋ねている理由は、私が中国語のテキストを扱っているからです。中国語では、スペースは単語の区切り文字として使用されません。スペースが追加されると、テキストは適切にフォーマットされていないように見えます。次に例を示します。

没有空格就合い。</p>

対

多了空格不好看。</p>

何か案は？

最初の質問ストリーム

こんにちは、みんな、

これは、この質問のフォローアップになる可能性があります：Antlrルールの優先順位

reStructuredTextマークアップ言語用のANTLR文法を書き込もうとしています。

私が直面している主な問題は、「他の文法規則をマスクせずに、文字のシーケンス（通常のテキスト）をどのように一致させるか」です。

インラインマークアップのある段落の例を見てみましょう。

インラインマークアップテキストのルールを書くのは簡単だと思いました。だから私は簡単な文法を書きました：

この単純な文法は機能しません。そして、私は通常のテキストと一致させようとさえしませんでした...

私の質問：

• 誰かが私のエラーを指摘し、通常のテキストと一致させる方法についてのヒントを教えてもらえますか？
• 文法規則に優先順位を設定する方法はありますか？多分これはリードかもしれません。

よろしくお願いします:-)

ロビン

2番目の質問ストリーム

ご助力ありがとうございます！エラーを理解するのに苦労したでしょう...私はANTLRを学ぶためにその文法（のみ）を書いているのではなく、Eclipse用のIDEプラグインをコーディングしようとしています。そしてそのために、私は文法が必要です;）

私はなんとか文法をさらに進めて、textルールを書きました：

文法はinline_markupで正常に機能していますが、normal_textが一致していません。

これが私のテストクラスです：

そして私が使用する入力ファイル：

そして、私はこの出力を取得します：

私のエラーを指摘できますか？（文法にfilter = true;オプションを追加すると、パーサーはエラーなしでインラインマークアップに対して機能します）

ロビン

Sphinxを使用してHTMLおよびPDFにレンダリングされるreSTドキュメントを作成しています。私のソースファイルはUTF-8であり、HTMLがUTF-8として表示されることを期待しています。

乗算記号を書くためのベストプラクティスは何ですか？

つまり、xではなく×です。

Unicode文字として挿入できることはわかっています。LaTeXを書いている場合は、を使用します\times。HTMLには。があり×ます。Sphinxですべてをレンダリングすると、単純なUnicodeは変換プロセスを適切に乗り切ることができますか？他のよりエキゾチックなフォーマットにレンダリングしても？

これがどこかで物事をつまずかせないことを再確認したいだけです。

私は LaTeX をいくらか書いてきましたが、最近は怠け者のように感じており、読みやすくするために Markdown、reStructuredText、または Textile で次の大きなプロジェクトを書きたいと思っています。残念ながら、TeX のカスタマイズ機能をいくつか持ち、セマンティック ニーズを満たす独自の構文構造を書きたいと思っています。

このようなマークアップ言語に私が望むことの 1 つは、LaTeX および (X)HTML 出力を生成する既存のプラグイン/フィルターがあることです。

私のニーズはそのままでは満たされない可能性があるため、副次的な質問として、新しいパーサーの多くは Python で記述されているため、新しい構文を簡単に挿入できる特にクリーンな Python 実装はありますか?

Restructured Textでテキストをストライクすることは可能ですか？

<strike>たとえば、HTMLに変換されたときにタグ としてレンダリングされるもの（ ReSTructuredTextなど）