========================
显示代码
========================

总得来说，codeblock代码块指令有两种形式，一种是直接将代码放入代码块中，另一种是引用已有的文件的代码将其放入代码块中。


.. admonition:: 语法高亮支持的语言

   支持以下值：

   * ``none`` （无突出显示）
   * ``default`` （类似于 python3 但却退缩到 none 不带警告的突出显示失败；默认情况下 highlight_language 未设置）
   * ``guess`` （让Pygments根据内容猜测lexer，只适用于某些可识别的语言）
   * ``python``
   * ``rest``
   * ``c``
   * ``java``
   * … 以及其他语法高亮 `Pygments supports <https://pygments.org/languages/>`_  


代码形式：

* 前者： ``.. code-block:: code_language_type``
* 后者： ``.. literalinclude:: code_file_path(local or internet)``

|75|

使用codeblock
===========================

.. code-block:: rest

   .. code-block:: java

      public class HelloWorld {
         public static void main(String[] args){
            System.out.println("Hello World!");
         }
      }

|15|

运行效果如下：

.. code-block:: java

   public class HelloWorld {
      public static void main(String[] args){
         System.out.println("Hello World!");
      }
   }

|50|

为代码块添加标题和 label 
============================


.. code-block:: java
   :caption: 代码块添加标题示例
   :name: HelloWorldExampleCodeBlock

   public class HelloWorld {
      public static void main(String[] args){
         System.out.println("Hello World!");
      }
   }

|15|

.. code-block:: rest
   :caption: 代码块添加标题示例代码

   .. code-block:: java
      :caption: 代码块添加标题
      :name: HelloWorldExampleCodeBlock

      public class HelloWorld {
         public static void main(String[] args){
            System.out.println("Hello World!");
         }
      }

|50|

显示行号
=========================

.. code-block:: rest

   .. code-block:: java
      :linenos:

      public class HelloWorld {
         public static void main(String[] args){
            System.out.println("Hello World!");
         }
      }

|15|
 
运行效果如下：

.. code-block:: java
   :linenos:

   public class HelloWorld {
      public static void main(String[] args){
         System.out.println("Hello World!");
      }
   }

|50|
 
突出特定行
========================

.. code-block:: rest

   .. code-block:: java
      :emphasize-lines: 1,3-5
      :linenos:

      public class HelloWorld {
         public static void main(String[] args){
            System.out.println("Hello World!");
         }
      }

|15|

突出3到5行的运行效果如下：

.. code-block:: java
   :emphasize-lines: 1,3-5
   :linenos:

   public class HelloWorld {
      public static void main(String[] args){
         System.out.println("Hello World!");
      }
   }

|50|

.. _literalinclude-directive:


引用一个文件 literalinclude
==================================

.. code-block:: rest

   .. literalinclude:: ../example/Not_regular_expression.py
      :language: python
      :linenos:
      :lines: 1-2,30-

|15|

运行结果如下；显示文件的第1到2行，以及30行之后的代码：

.. literalinclude:: ../example/Not_regular_expression.py
   :language: python
   :linenos:
   :lines: 1-2,30-

|50|

指定引用文件的方法，或类
================================

指令支持包含文件的一部分. 例如 Python模块, 可以选择类，函数或方法，使用 pyobject 选项。

.. code-block:: rest

   .. literalinclude:: ../example/Not_regular_expression.py
      :pyobject: isPhoneNumber

|15|

运行效果如下：

.. literalinclude:: ../example/Not_regular_expression.py
   :pyobject: isPhoneNumber

|50|


diff2个文件
===================

.. code-block:: rest

   .. literalinclude:: ../example/Not_regular_expression.py
      :diff: ../example/Not_regular_expression2.py

|15|

运行效果如下：

.. literalinclude:: ../example/Not_regular_expression.py
   :diff: ../example/Not_regular_expression2.py

|50|

锚点小测试
====================

点击前往 :ref:`代码块添加标题示例 <HelloWorldExampleCodeBlock>` 

|15|

.. code-block:: rest

   点击前往 :ref:`代码块添加标题示例 <HelloWorldExampleCodeBlock>`