Kivy - 重組文字

reStructuredText 是一種文字檔案格式，包含主要用於 Python 技術文件的資料。該檔案通常具有“.rst”副檔名。

• reStructuredText 是 DocUtils 專案的一部分，其主要目的是為 Python 提供一組類似於 Java 的 Javadoc 的工具。由 David Goodger 編寫，其最早版本於 2001 年釋出，最新版本於 2019 年釋出。

• reStructuredText 可以被認為是一種輕量級標記語言，與 MarkDown 語法有很多相似之處。它被用作 Python 的 Sphinx 文件生成系統的核心元件。

Kivy 以 RstDocument 類的形式提供重組文字文件渲染器，該類定義在“kivy.uix.rst”模組中。

from kivy.uix.rst import RstDocument
doc = RstDocument(**kwargs)

格式化重組文字

• 段落 - 由空行（一個就足夠了）分隔的文字塊。段落必須具有相同的縮排。

• 粗體 - 兩個星號之間的字元（例如：**Hello**）

• 斜體 - 單個星號之間的字元（例如：*world*）

• 列舉列表 - 以數字或字母開頭，後跟句點“.”，右括號“)”或括在括號“( )”中。例如 -

1. Python
2. Java
3. C++

• 專案符號列表 - 以專案符號字元開頭 -“-”、“+”或“*”

• 章節 - 這些是帶有修飾的單行文字（一個或多個單詞）：單獨的下劃線，或下劃線和上劃線一起，用短劃線“-----”，等號“======"

• 圖片 - 要在文件中包含圖片，可以使用 image 指令。例如 -

.. image:: kivi-logo.png

示例

以下文字根據 reStructuredText 語法進行格式化。將以下文字儲存為 index.rst -

================
Welcome to Kivy
================
Welcome to Kivy's documentation. **Kivy** is an open source software library for the rapid development of applications equipped with novel user interfaces, such as multi-touch apps.
With Kivy, you can create apps that run on:

* Desktop computers: macOS, Linux, *BSD Unix, Windows.
* iOS devices: iPad, iPhone.
* Android devices: tablets, phones.


-------------------
Virtual environment
-------------------
Create the virtual environment named kivy_venv in your current directory_::

   python -m virtualenv kivy_venv
   
Activate the *virtual environment*.

For Windows default CMD, in the command line do_::
   kivy_venv\Scripts\activate
   
Your terminal should now preface the path with something like (kivy_venv), indicating that the kivy_venv environment is active.
If it doesn't say that, the virtual environment is not active and the following won't work.

Install Kivy
------------
The simplest is to install the current stable version of kivy is to use pip_::

   python -m pip install "kivy[base]" kivy_examples

讓我們編寫一個程式，在 Kivy 應用程式中渲染此重組文字文件。我們將 RstDocument 元件放在具有單列的網格佈局中。將此物件的 source 屬性設定為我們建立的 RST 檔案。

from kivy.app import App
from kivy.uix.rst import RstDocument
from kivy.uix.gridlayout import GridLayout
from kivy.core.window import Window

Window.size = (720,400)

class rstdemoapp(App):
   def build(self):
      grid=GridLayout(cols=1)
      doc = RstDocument(source="index.rst")
      grid.add_widget(doc)
      return grid
rstdemoapp().run()

輸出

執行以上程式碼。RST 文件將根據上面解釋的格式化語法顯示。