獅身人面像：將代碼段放在無序列表項的第一行

Question

我使用Sphinx來管理我的項目文檔。

我有一個無序的列表，我想每個項目的第一行是一個代碼段。 （不內聯，一段。）

我該怎麼做？

Answer 1

看着我自己的文檔我發現了一個類似的方案，但我不能保證，它將與文檔作爲第一文本列表中的工作：

#. **Defining the Model Class** 

    All models must inherit from |LrbBaseModel| either directly or 
    indirectly and have the |LrbModelInit| decorator above their 
    constructor (a.k.a. ``__init__``):: 

     class foo(LrbBaseModel): 
      @LrbModelInit() 
      def __init__(self): 
       ... 

這將產生：

我認爲你可以擺脫一個代碼塊沒有前同步文本類似如下：

#. :: 
     def fooDeFaFa(): 
      pass 

請注意，我的代碼塊縮進了兩次。 ::表示空的文本段落塊，然後我的代碼再次通過縮進來定位此::語法的子元素。

或者，這可以工作：

#. 
    :: 
     def fooDeFaFa(): 
      pass