我時常用 Kobo 閱讀器來看電子書，在閱讀的過程中，我會順手把看了有感覺的句子標註起來，另外我也會用 Notion 來記錄我的閱讀清單，我想利用程式自動把 kobo 閱讀器裡的標註段落(Highlights)匯入到 Notion 裡，該如何做呢?
步驟 1: 建立 Notion integration
要與 Notion 互動，第一步是要建立 Integration. 打開 https://www.notion.so/my-integrations 並且點選 「New integrations」，例如我建立了「kobo-export」，
建立好 integration，進去該頁面，可以得到 Integration Secret (晚點程式需要）
步驟 2: 將閱讀清單頁面連上integration
在 Notion 頁面右上角有「…」，選擇 Connect → export-kobo，將頁面連結上 integration，程式才有權限讀寫該頁面。
步驟 3: 取得閱讀清單頁面的database id
連上 web 版 Notion，選取讀清單頁面，我們可以從 url 取得database id
例如閱讀清單頁面 的URL 是
https://www.notion.so/xxxx/2a6a8e2667894f4e9ea4ea5191e98f26
database id 就是 2a6a8e2667894f4e9ea4ea5191e98f26
步驟 4: 取得 Kobo sqlite database
將 Kobo 閱讀器連接上電腦，在隱藏資料夾「./kobo 」下有 KoboReader.sqlite，裡面存有閱讀器上標註的 Highlights，將該檔案與 export 程式放在同一目錄下。
步驟5: 建立 export 程式
在 export.py 裡面，我們先要準備 .env file，裡面有 NOTION_KEY(步驟1取得) 和 NOTION_DB_ID (步驟3取得)
NOTION_KEY=secret_xxxxxxxxxxxxxxxxxxx
NOTION_DB_ID=2a6a8e2667894f4e9ea4ea5191e98f26
利用 NOTION_KEY，我們可以 create notion client
from notion_client import Client
self.client_secret = os.getenv('NOTION_KEY')
self.client = Client(auth=self.client_secret)
假設我們打算要匯入《明日，明日，又明日》這本書的 highlights，
我們要先在閱讀清單頁面找到該書的頁面(如下)
我們利用 notion client 來 query database
def query_parent_page(self, title):
try:
my_page = self.client.databases.query(
**{ "database_id": self.reading_db_id,
"filter": {
"property": "Title",
"rich_text": {
"contains": title,
},
},
}
)
if my_page:
return my_page["results"][0]['id']
else:
return None
except APIResponseError as error:
print(error)
找到該書的頁面之後，我們要在這個頁面下面建立一個「Kobo Highlights」的頁面，
def create_highlight_page(self, target_page_id):
highlight_page = self.client.pages.create(
**{ "parent": {
"type": "page_id",
"page_id": target_page_id
},
"properties": {
"title": [
{
"text": {
"content": "Kobo Highlights"
}
}
]
}
}
)
return highlight_page['id']
結果就像這樣
建立好頁面，我們就可以從 KoboReader.sqlite 讀取 Highlights，並寫到新建立的 「Kobo Highlights」頁面
def export_highlight_to_notion(self, title):
books_in_file = pd.read_sql("select c.ContentId AS 'Content ID',
c.Title AS 'Book Title' from content As c。
where c.Title like '%"+title+"%'", self.conn)。
if len(books_in_file):
print(f"step3: find book in kobo db, title = {title}, books number = {len(books_in_file)}")。
for i in range(0,len(books_in_file)):
bookmark_df = pd.read_sql("SELECT VolumeID AS 'Volume ID',
Text AS 'Highlight', Annotation, DateCreated AS 'Created On',
Type " + "FROM Bookmark Where VolumeID = '" + books_in_file['Content ID'][i] + "'" " ORDER BY 4 ASC", self.conn)。
print(f"step4: write highlight into notion, highlight number = {len(bookmark_df)}")。
for j in range(0, len(bookmark_df)):
if bookmark_df['Highlight'][j] != None: bookmark_df['Highlight'][j] = bookmark_df['Highlight'][j].strip()。
for x in range(0, len(bookmark_df)):
if bookmark_df['Type'][x] == 'highlight':
self.write_text(target_page_id, bookmark_df['Highlight'][x], 'paragraph')。
else:
if bookmark_df['Annotation'][x] != None:
self.write_text(target_page_id, bookmark_df['Annotation'][x], 'quote')。
if bookmark_df['Highlight'][x] != None:
self.write_text(target_page_id, bookmark_df['Highlight'][x], 'paragraph')
全部的程式碼我放在github:
