問題タブ [restructuredtext]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票する
2 に答える
1276 参照

python - restructuredText を取得してすべての html にクラスを追加する方法

鬼ごっこ?

Django のマークアップ パッケージを使用して、restructuredText を html に変換しています。<p>各タグにクラス属性を追加するように HTML ライターをカスタマイズする方法はありますか?

段落ごとにクラス ディレクティブを使用することもできますが、このプロセスを自動化したいと考えています。

たとえば、次の再構成されたテキストが必要です。

このhtmlに変換します。

クラスを挿入したい理由は、「ハイフネーション」クラスを持つすべてのタグにハイフンを追加することで機能するハイフネータ ライブラリを使用しているためです。ハイフネート クラスをコンテナ タグに追加することもできますが、その場合、すべての子がハイフネート クラスを継承してしまいます。javascript を使用して動的にクラスを追加することもできましたが、restructuredText を使用して簡単に追加できる方法があるのではないかと考えました。

助けてくれてありがとう、

ジョー

0 投票する
4 に答える
9879 参照

markup - restructuredText の記号

restructuredText でいくつかのシンボルを使用したい。これどうやってするの?(たとえば、Markdownでは、標準 HTML 文字エンティティ&rarr;のリストで定義されている「→」記号が生成されます。w3c リファレンスも参照してください)

注: 数式のサポートを依存関係として要求したくありません。

0 投票する
2 に答える
848 参照

php - PHP の外部ドキュメント、DocBook なし

PHP プロジェクトのドキュメンテーション システムが必要で、コード コメントから生成されたドキュメンテーションと外部ドキュメンテーション (ユース ケース、プロジェクト スコープなど) を統合できるようにしたいと考えていました。phpDocumentor は正確に適切な機能セットを備えているようですが、外部ドキュメントは DocBook で作成する必要があり、これは私たちのチームにとって複雑すぎます。

それが Python の場合、sphinx はこの仕事にほぼ完璧です (ReST は間違いなく docbook よりも簡単です)。外部の ReST ドキュメントを phpdoc から抽出したドキュメントと統合する方法はありますか? 外部ドキュメントを分離する必要がありますか (たとえば、外部には ReST を使用し、内部には phpdoc を使用します)。または、外部ドキュメントを管理するためのより良い提案はありますか?

0 投票する
1 に答える
1107 参照

database - DBに保存するマークアップ言語は何ですか?

関連:軽量フォーマット(テキスタイル、マークダウン)をデータベースに保存する方法は?

コメントのフォーマットをマークアップ言語でDBに保存したいと思います。ただし、複数のフォーマット言語(マークダウン、テキスタイル、restructuredText)を許可する必要があります。それらの間で変換できるように、それらの機能のスーパーセットを保存する必要があるようです。

  • これは機能しますか?
  • そのようなスーパーセットはありますか?
  • それらを切り替えるライブラリはありますか?
  • DBにコメントを保持する必要があるより構造化された形式はありますか?

(重要な場合はPython / Google App Engine)

0 投票する
2 に答える
863 参照

python - Sphinx-Tracチケットとチェンジセットへの自動参照を生成します

Sphinxは、 Tracの対応するチケット/チェンジセットのよう#112なテキストを自動的にリンクする方法はありますか?r1023

例:

その他の例については、 TracLinksを参照してください。

0 投票する
5 に答える
3769 参照

html - 再構成されたテキスト用の単純な Web ページ コンパイラとは?

ブログ/cms の代わりに、いくつかの (めったに更新されない) ページを含む静的な html ベースのサイトが欲しいです。それらを更新する最も簡単な方法は、ソースをReSTのような形式に保ち、更新するたびにコンパイルすることだと思います。この用途に推奨されるコンパイラは何ですか? 独自のテーマ/デザインを持ちたいのですが、適切な ReST 構文以外は必要ありません (たとえば、Sphinx は多すぎます)。

0 投票する
3 に答える
8764 参照

python - Sphinxでは、パラメーターを宣言するとともにパラメーターを文書化する方法はありますか?

DRYを適用するために、パラメーターを宣言するのと同じ行に(必要に応じて)各パラメーターを文書化することを好みます

私がこのようなコードを持っている場合:

doc文字列でパラメーターを繰り返さないようにし、パラメーターの説明を保持するにはどうすればよいですか?

避けたい:

これは、Python2.6またはPython3で、ある種のデコレータ操作を使用して可能ですか?他に方法はありますか?

0 投票する
1 に答える
5548 参照

markup - ReStructuredText番号付きヘッダー

最初に自動ヘッダー番号を付ける方法はありますか?それは次のようなものです:

これは次のようにレンダリングされます。

1.いくつかのセクション

..。

1.1いくつかのサブセクション

..。

1.2別のサブセクション

..。

2.別のセクション

..。

0 投票する
1 に答える
1394 参照

python - xhtml/rst から Excel への変換

私はレポート ツールに取り組んでおり、pdf、html、Excel (.xls または Excel で簡単に開くことができる任意の形式) を含むさまざまな形式でレポートを生成する必要があります。

xhtml または restructuredtext(rst) で基本的なレポートを生成し、それを他の形式に変換することを考えています。pdf 変換に xhtml2pdf または rst2pdf を使用できますが、xhtml または rst を実行できるツール/ライブラリを見つけることができません。変換。

Q1. Excel コンバーターへの rst または xhtml はありますか?

他の選択肢は何ですか?たとえば、基本的なドキュメントを python オブジェクトのリストとして生成し、それらを reportlab 経由で pdf に変換するか、xlwt ( http://pypi.python.org/pypi/xlwt )経由で Excel に変換することを考えています。

Q2. そのような python ドキュメント モデルは既にありますか?

Q3. rst を生成し、それを解析して xlwt を使用して xls ファイルを生成するのはどれほど簡単でしょうか?

0 投票する
6 に答える
13657 参照

code-snippets - Sphinx、reStructuredTextコードスニペットの表示/非表示

私はSphinxreStructuredTextを使用してソフトウェアパッケージを文書化しています。

私のドキュメントには、長いコードスニペットがいくつかあります。それらを展開する小さな「表示/非表示」ボタンを使用して、デフォルトで非表示にできるようにしたいと思います()。

それを行うための標準的な方法はありますか?