[TOC] ## 命令行提示符 在本書的教授過程中，我將使用 `$` 符號來作為命令行提示符，如： ```shell $ echo "Hello ThinkPHP!" Hello ThinkPHP! ``` 帶有 `$` 符號的第一行代碼指的是我們在命令行端口中輸入的命令 `echo "Hello ThinkPHP!"`。`echo` 是 Unix 系統中常用的輸出命令，用于輸出指定字符串。第二行的 `Hello ThinkPHP! `是運行命令后的輸出信息。后面我們會使用這種風格來表示命令行的輸入與輸出，因此你在復制命令行的時候要注意不要把 `$` 和輸出信息也復制進去了。 由于接下來的教程有時會在兩個不同的機器環境上（宿主環境和虛擬機環境，大部分情況下是在虛擬機環境上）來調用命令行輸入，因此我們約定，在宿主上調用的命令輸入使用 `>` 符號，在虛擬機上調用的命令使用 `$` 符號。 以下命令行運行在 **虛擬機** 里： ```shell $ echo "I am in VM!" I am in VM! ``` 以下命令行運行在 **宿主機** 上： ```shell > echo "I am in Host Machine!" I am in Host Machine! ``` ## 相對文件路徑 針對每個人不同的工作環境，本書將統一默認為項目的根目錄，而不是項目在文件系統中的完整路徑。 例如在我電腦中項目默認模塊的默認控制器文件的完整路徑為： ```shell /home/vagrant/Code/ThinkBBS/app/index/controller/Index.php ``` 但在本書中，文件名路徑參照的是項目的根目錄，顯示如下： ```shell app/index/controller/Index.php ``` 這樣就能保證每個人看到的路徑名稱都一致了。 ## 豎排 '...' 代碼省略 最后，為了保持文章的篇幅簡潔，我會將一些不必要的代碼使用豎排的 `.` 來代替，你在復制本文代碼塊的時候，切記不要將 `.` 也一同復制進去。演示代碼如下： ```php <?php namespace app\index\controller; . . . class Topic extends Base { public function index() { return $this->fetch('topic/index'); } } ``` ## 排版規范 此文檔遵循 [中文排版指南](https://github.com/sparanoid/chinese-copywriting-guidelines) 規范，并在此之上遵守以下約定： - 英文的左右保持一個空白，避免中英文字黏在一起； - 使用全角標點符號； - 嚴格遵循 Markdown 語法； - 原文中的雙引號（" "）請代換成中文的引號（『』）； - 「`加亮`」和「`加粗`」和「`[鏈接]()`」都需要在左右保持一個空格。