建立 README

GitHub 概念入門

Jasmin Ludolf

Content Developer, DataCamp

編輯 README

足球分析資料庫的檢視畫面

GitHub 概念入門

編輯 README

足球分析資料庫,已反白顯示 README 檔案

GitHub 概念入門

編輯 README

足球分析資料庫,已反白顯示編輯 README 檔案的鉛筆圖示

GitHub 概念入門

Markdown

README 檔案檢視畫面

GitHub 概念入門

編輯 vs. 預覽

README 檔案中的編輯與預覽分頁標籤

GitHub 概念入門

標題

Markdown 檔案編輯頁面,包含最大標題的語法

Markdown 檔案預覽頁面,顯示最大標題

GitHub 概念入門

標題

Markdown 檔案編輯頁面,顯示六種標題語法

Markdown 檔案預覽頁面,顯示六種標題

GitHub 概念入門

標題

Markdown 檔案編輯頁面,顯示六種標題語法]

Markdown 檔案預覽頁面,六種標題,並以箭頭指向一級與二級標題下方的底線

GitHub 概念入門

文字格式

Markdown 檔案編輯頁面,顯示粗體與斜體語法

Markdown 檔案預覽頁面,顯示粗體與斜體文字

GitHub 概念入門

超連結

Markdown 檔案編輯頁面,顯示超連結語法

Markdown 檔案預覽頁面,顯示超連結

GitHub 概念入門

超連結

點擊超連結的動畫示意

GitHub 概念入門

圖片

將影像拖曳到 Markdown 檔,GitHub 自動產生語法的動畫

GitHub 概念入門

撰寫 README

  • 內容需具描述性
    • 讓任何人都看懂專案
  • 列出版本庫內容
  • 清楚向他人說明專案

打開書本的插圖

GitHub 概念入門

README 基本要素

  • 標題
  • 技術說明
    • 為什麼?
  • 流程說明
    • 為什麼?
  • 目錄
GitHub 概念入門

README 進階內容

  • 專案起源
  • 動機
  • 侷限
  • 挑戰
  • 想解決的問題
  • 預期用途
  • 致謝
GitHub 概念入門

一起來練習吧!

GitHub 概念入門

Preparing Video For Download...