協作閣 for LOPE

# 協作閣 for LOPE
### 
### March 15, 2019 <a href='https://bit.ly/LOPE0221' style='font-size:0.7em;'>bit.ly/LOPE0221</a>

---

## Outline

- 文章上傳

- 修改文章
]

---

# 文章撰寫

---

## 文章撰寫

- 格式：
    - **Markdown** (`.md`)
    - **R Markdown** (`.Rmd`)
    - **Jupyter Notebook** (`.ipynb`)
    
- **`.md`** 與 **`.Rmd`**：使用**.red[相對路徑 (relative path)]**

````md
 ![](path/to/img.png) 
 ![](https://example.com/img.png) 
 ![](/this/is/absolute/path/on/collabin) 
 ````
 
 ````r
 source('./path/to/file.csv') # Correct
 source('path/to/file.csv') # Correct
 source('/Users/who/i/cant/find/file.csv') # WRONG !!!
 ````

- **`.ipynb`**：請**.red[先跑出結果]** (i.e. `.ipynb` 內含圖片、程式執行結果)

---

# 文章上傳

---
## 文章上傳

1. 撰寫：**`index.Rmd`** + dependencies (figures, `.R`)

1. 確認：使用[相對路徑](#4)、可 knit 成 HTML

1. 壓縮：`index.Rmd` + dependencies → **`.zip`**

1. [上傳](https://goo.gl/forms/t76C5JNDjMx8DxX42)：填寫文章資訊 (標題、文章標籤等)

]

---

## 文章上傳

1. 撰寫：**`index.md`** + dependencies (figures)

1. 確認：使用[相對路徑](#4)

1. 壓縮：`index.md` + dependencies → **`.zip`**

1. [上傳](https://goo.gl/forms/t76C5JNDjMx8DxX42)：填寫文章資訊 (標題、文章標籤等)

]

---

## 文章上傳

1. 撰寫：**`index.ipynb`**

1. 執行：先跑出結果 (`.ipynb` 內含圖片、程式執行結果)

1. 壓縮：`index.ipynb` + dependencies\* → **`.zip`**

1. [上傳](https://goo.gl/forms/t76C5JNDjMx8DxX42)：填寫文章資訊 (標題、文章標籤等)

]

---

## 文章上傳

1. [上傳](https://goo.gl/forms/t76C5JNDjMx8DxX42)：

- **`url.txt`** (內含文章連結)
    
    - 填寫文章資訊 (標題、文章標籤等)
    
- 有個人網站或部落格者，可使用這種方式新增文章。協作閣會放上 `url.txt` 內的文章連結。
]

---

# 修改文章

---

## 純文字修正

1. 協作閣文章頁面點擊 <img style="display:inline-block;height: 1em;margin-bottom:0" src="https://bit.ly/2RRirG7">

1. 透過 GitHub 修改文章\*

1. 提出 Pull Request
]

.footnote[
.smaller[
\[\*\]: 第一次編輯時，會跳出需要 Fork 的畫面，請按確定。編輯的過程可完全透過網頁進行，別擔心會因為按錯什麼而毀損檔案。如果完全不會使用 GitHub，可將修改過的檔案寄給我。
]
]

---

## 計算上的修正

1. **`.Rmd`** ,  **`.md`**
    
  - 同上一張投影片 (透過 GitHub)

1. **`.ipynb`**
  
  - 將新的 `.ipynb` 傳給我