2017-06-13 45 views
6

Ben UNIX tree komutunu kullanarak benim ürünün yapısının bir ağaç görünümünü içeren bir kod bloğu var.Kod bloğuna nasıl dahili referans eklenir?</p> <pre><code>|── parent |   |── child |   |── grandchild </code></pre> <p>Sfenks boşlukları korur, böylece bir kod bloğu var: my Sfenks'in .rst belgede

Okuyucular, bu düğümü açıklayan belgenin bir kısmına internal hyperlink numarasını uygulamak için her bir düğüme tıklayabilmelerini istiyorum. Bununla birlikte, kod bloğu içinde :ref: eklenmesi işe yaramaz (aşağıya bakın). Bunu nasıl başaracağını bilen var mı?

Bu işe yaramazsa: Sonra

.. _parent: 

Parent 
------ 
Blah blah 

.. _child: 

Child 
----- 
Blah blah 

.. _grandchild: 

Grandchild 
---------- 
Blah blah 

...:

|── :ref:`parent` 
| |── :ref:`child` 
|  |── :ref:`grandchild` 

Herhangi yardım büyük takdir!

cevap

3

Sen parsed-literal direktifini kullanabilirsiniz:

.. parsed-literal:: 

    |── :ref:`parent` 
    | |── :ref:`child` 
    |  |── :ref:`grandchild` 

Bu çalışır, ancak söyleyerek uyarı mesajı söz konusuysa "UYARI:. Inline substitution_reference start-dize sonu dize olmadan"

Dikey çubuklar substitution references'un parçaları olarak yorumlanır. uyarılar bazı kaçması ile gitmesini:

.. parsed-literal:: 

    \|── :ref:`parent` 
    | \|── :ref:`child` 
    |  \|── :ref:`grandchild` 
1

.. code-block:: literal kodu ve dizim dışında çözümlenen almaz.

Bunun yerine ağacına stilleri uygulamak için bir CSS sınıfı my-special-class kullanmak ve HTML en <pre> veya <code> benzer CSS stilleri yazabiliriz. Ayrıca, |'dan \| olarak çıkmanız gerekecektir, çünkü reST, |'u bir ikame olarak ayrıştırmaya çalışır.

Rest:

.. rst-class:: my-special-class 

\|── :ref:`parent` 
\| \|── :ref:`child` 
\|  \|── :ref:`grandchild` 

CSS:

.my-special-class { 
    font-family: monospace; 
    white-space: pre; 
}