2017-08-06 35 views
4

私はスフィンクスのドキュメントの末尾の空白でインラインコードを使用するには?

``# `` 

を使用すると、私は次の警告を得る:

:samp:`# ` 

をしようと

WARNING: Inline literal start-string without end-string. 

WARNING: Inline interpreted text or phrase reference start-string without end-string. 

PRにつながりますoblemは末尾の空白のようですが、私はこの問題を回避する方法を理解できませんでした。空白をバックスラッシュ(\)でエスケープしても、最初の例では警告が表示され、2番目の例では生成されたドキュメントでは空白が省略されます。

This answerインラインコードセクションは、|space|をリテラル文字列として解釈するため、機能しません。


スフィンクス1.6.2で経験。

+1

[Sphinxにバグレポートを送信する](https://github.com/sphinx-doc/sphinx/issues/new)をお勧めします。この質問を参考にしてください。私は回避策も見つけられませんでした。 –

+0

同じこと、運がそれをしない! –

+0

@StevePiercyバグについて言えば、どのような動作が期待されますか?バックスラッシュの仕事で脱出すべきか? –

答えて

2

末尾の空白に通常のスペース(U + 0020)ではなく、改行なしのスペース文字(U + 00A0)を使用することを回避することです。

リテラルの改行なしの空白文字を挿入する方法はいくつかあります。 https://en.wikipedia.org/wiki/Non-breaking_space#Keyboard_entry_methodsを参照してください。

+0

お返事ありがとうございます。しかし、私はどのようにソースにNBSPを挿入するか分からない。 [ドキュメンテーション](http://docutils.sourceforge.net/docs/ref/rst/directives.html#unicode)によると、Unicode指令は置換定義とAFAIKでのみ使用でき、インラインコードセクションでは使用できません。さらに、私のドキュメントをコンパイルするときに、HTMLの場合、これはおそらく別のHTMLエンティティとして終わるでしょう(視覚的な目的を果たす可能性が最も高いですが、コピーされたコードは目的とは異なるキャラクターになります。 –

+0

回答が更新されました。私はEmacsを使い、 'Ctrl-X 8 Space'はうまく動作します。 – mzjn

+1

私はそれを挿入して、それがうまく動作することを確認しました。コンパイルされたHTMLソースに ' 'を挿入します(とにかく、これがHTMLに後ろの空白を持つ唯一の方法かもしれません)。コピー&ペーストの部分にコメントすることができますか?つまり、レンダリングされたHTMLからインラインコードセクションをコピーするとどうなりますか?彼らは通常のスペースまたは非区切りのスペース文字をコピーしてしまうでしょうか?これはおそらくブラウザエンジン(?)に依存し、FirefoxとChromeで試してみると、通常のスペースをコピーしてしまいました。 –

関連する問題