Markdown 語法 (syntax) 和 範例 (sample)

Markdown 是一個非常方便用來寫部落格的語法。可以透過一些定義好的符號或格式，便可輕易的編排你的文章，先不需要使用大量的HTML，雖然最後仍是需要轉換成HTML。先讓我們先下面的範例：

> ### This is a header
> 
> 1. This is the first list item.
> 2. This is the secord list item.

如此所產生的結果如下：

This is a header

1. This is the first list item.
2. This is the secord list item.

就以上所產生的結果，我們可以看到

1. Blockquotes: Email形式的區塊引言，也在左側上一條灰色的直線，它是利用一個">"的符號所產生的。
2. 標題：Markdown 所支援的標題從 H1 到 H6。H1 字型最大，而 H6 字型最小；它是以"#"符號來表示，一個＃為 H1；而六個＃為 H6；
3. 有序清單：以一個數字開頭接著一個小數點，後面至少要接著一個空格，來表示。另外，還有無序清單，可用符號"*" "+" "-"一個加一個空格來表示。

---

除了這些，還有

• 程式碼區塊：以一個tab或四個空格開始，結果會產生如下圖，一個區域。
  

  我是程式碼區塊

• 分格線：用三個或以上的星號、減號、底線來建立分隔線。
• 連結：在字串中，有個關𨧞字會連到指定的網址。以[方括號]標記，接著以括號填入綱址如下：
  

   如同我在[之前](http://cypress-soho.blogspot.tw/)所提到的... 

• 強調：在要__強調__的文字，在前後加入一或二個的星號或底線。
  

  *singleasterisks*
  _single underscores_
  **double asterisks**
  __double underscores__
  

  結果為
  singleasterisks
  single underscores
  double asterisks
  double underscores
  
  
• 坎入圖片：和連結有像，但差別在多了一個驚嘆號。
  

  ![圖片的替代文字](http://localhost/cat.png)

有關更詳細 markdown語法，請看這裡

本機上簡單易上手的 Source Code Control - git

若只是要在自已的電腦上，擁有一個簡單易使用的原始碼管理系統(Version Control System:VCS)，我認為 git 是一個不錯的選擇。在此提供一個很簡單的示範和說明；看完這篇你可以得到： 1. 看完示範和說明，你就可以馬上在你的電腦上使用 git 。 2. 瞭解git中的 working directory - staging area - repository 之間的關係。 3. 如何修改 git容器的名稱。
第一個範例如下：

$ mkdir demo
$ cd demo
$ git init
Initialized empty Git repository in /root/demo/.git/
$ touch foo
$ git add foo
$ git commit 0m 'a demo'

在這個範例中，有三個 git 的指令，分別是 init / add / commit；
init : * 這指令會在目前的目錄下 (即為工作目錄working directory的根目錄)，產生一個 ".git" 的子目錄，這個名為 ".git" 的子目錄，即為git 的容器(repository)。

• 而技術上 ".git"的名稱是可以改的，只要在執行 init 前，宣告一個 GITDIR＝"你希望的名稱" 的環境變數即可。例如 "export GITDIR=.test" 。再執行 init ，便會產生一個名為 ".test"的子目錄為 git容器！
• 另外，git 和 svn 不同的是 git容器只會存在工作目錄的根目錄；而 svn系統下，名為 ".svn"的子目錄，會存在於根目錄和其所有的子目錄。

add： * 在工作目錄下，任何新增或修改過的檔案。要送交(commit)至容器前，一定要先註記為已完成階段性(staging)工作。故透過 add 指令，將註記新增或修改過的檔案，並加入已完成階段性檔案區域 (staging area)。(staging area僅是個邏輯的區域，並不會真的有個目錄作為staging area)

• 已放入 staging area的檔案，若有新的修改，即會被強迫脫離staging area，取消註記。需再透過 add 指令重新註記檔案。

commit : * 最後，透過 commit 指令，將目前的版本送交至容器。
整個狀態，可以用下圖來描述：

而在第一次送交時，可能會有下列錯誤訊息。

那是因為 git 要求要有記錄是誰送出這次送交的。可就訊息中的指令範例去設定使用者名稱和使用者 Email。這只要設定一次即可。設定後，會在使用者家目錄下，產生一個 ".gitconfig" 檔案，記錄著你的設定。

git - 看懂 file status

當在管理 git 時，經常會使用 git status 來檢視目前工作目錄(working directory)下，有那些檔案被修改了，而又有那些修改過的檔案已經放入已完成階段性工作區域 (staging area)。所以，git status 算是非常常用的指令。

話不多說，直接先在工作目錄下執行 git status 看看吧～

在上圖範例中，告訴著有那些訊息呢？

1. On branch master : 目前正位於master 分支上。
2. Changes to be committed: 描述著有那些檔案已經放入 staging area。目前看到有一個被修改過的檔案 "foo" 正等著被送交(commit)。
3. Changes not staged for commit: 列出了那些在容器中存在的檔案，而被修改過尚未加入 staging area。
4. Untracked files: 列出那些檔案，是 git 從未追蹤過的新檔案。