update readme for new features

README.md

@@ -5,7 +5,8 @@
 # Usage
 ## Basic
 
-- 取得看板資訊 (metadata)，可用參數`no_school`調整是否取得學校看版內容。
+- 取得看板資訊 (metadata)
+    - 可用參數`no_school`調整是否取得學校看版內容。
 
 ```python
 from dcard import Dcard
@@ -19,7 +20,9 @@ forums = dcard.forums.get(no_school=True)
 print(len(forums))
 ```
 
-- 取得看板文章資訊 (metadata)，一頁有30篇文章。可用`pages`指定頁數數量，文章排序有兩種選擇: 'new' / 'popular'。
+- 取得看板文章資訊 (metadata)，一頁有30篇文章
+    - 可用 `pages` 指定頁數數量
+    - 文章排序有兩種選擇: `new` / `popular`
 
 ```python
 ariticle_metas = dcard.forums('funny').get_metas(pages=5, sort='new')
@@ -28,7 +31,7 @@ ariticle_metas = dcard.forums('funny').get_metas(pages=1, sort='popular')
 print(len(ariticle_metas))
 ```
 
-- 提供一次取得 單篇/多篇 文章詳細資訊(全文、引用連結、所有留言)。
+- 提供一次取得 單篇/多篇 文章詳細資訊(全文、引用連結、所有留言)
 
 ```python
 # 放入 文章編號/單一meta資訊 => return 單篇文章
@@ -41,22 +44,41 @@ articles = dcard.posts(ids).get()
 articles = dcard.posts(ariticle_metas).get()
 ```
 
+- 下載文章中的資源 (目前支援文中 imgur 連結的圖片)
+  - 可加入限制 (constraints) 過濾出符合條件的文章後，再進行分析
+  - 可以使用多個限制條件
+  - 預設每篇圖片儲存至 `文章標題 (#文章編號)` 為名的新資料夾
+
+```python
+resources = posts.parse_resources(constraints={'likeCount': '>=100')
+resources = posts.parse_resources(constraints={'likeCount': '>=20', 'commentCount': '>10'})
+
+status = posts.download(resources)
+```
+
 ## Advanced
 
-- 提供自定義 callback function，可在接收回傳值前做處理 (reduce) 
+- 提供自定義 callback function，可在接收回傳值前做處理 (filter / reduce data)。
 
 ```python
 def collect_ids(metas):
     return [meta['id'] for meta in metas]
 
+
+def 標題含有圖片關鍵字(metas):
+    return [meta['id'] for meta in metas if '#圖' in meta['title']]
+
+
 ids = dcard.forums('funny').get_metas(pages=5, callback=collect_ids)
+ids = dcard.forums('funny').get_metas(pages=5, callback=標題含有圖片關鍵字)
+
 print(len(ids))
 ```
 
 - 爬取文章時提供 content, links, comments 三個參數，能選擇略過不需要的資訊以加快爬蟲速度。
 
 ```python
-articles = dcard.posts(ids).get(comments=False, links=False)
-print(len(articles))
+posts = dcard.posts(ids).get(comments=False, links=False)
+print(len(posts))
 
 ```