使用 Create-React-App 开发 Chrome 扩展
整理 Kindle 标注、书签和笔记从未如此简单!
Kindle 标注管理应用 Kindle Mate 只支持 Windows,不支持 Mac。标注只是解析我的剪贴文本文件,配合 FileReader API,写个 Chrome 扩展解析文本文件就好了。
初始化项目
安装 React 脚手架 create-react-app
npm i -g create-react-app
初始化项目
create-react-app my-clippings --typescript
--typescript 表示使用 typescript。强烈推荐使用 ts,Vue 3.x 使用 ts 重写,Angular 2.x+ 只能使用 ts,ts 是大势所趋。
删除 src/serviceWorker.ts 文件,用不着。
支持 Sass
安装 node-sass 即可。
若要支持 css modules,文件名从 index.scss 改为 index.module.scss 即可。
npm i -D node-sass
读取文件
读取的文件是 Kindle 中的 /documents/My Clippings.txt 文件,Kindle 设置任何语言都是这个文件。只不过在不同语言下的显示不一样。
使用 FileReader API 可以轻松读取文本文件。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<title>Document</title>
</head>
<body>
<input type="file" accept=".txt" id="file-upload" />
<script>
const dom = document.querySelector("#file-upload");
dom.onchange = function(event) {
const file = event.currentTarget.files[0];
const reader = new FileReader();
reader.readAsText(file);
reader.onload = () => {
const temp = reader.result;
console.log(temp);
};
};
</script>
</body>
</html>
解析文本
要解析的文本为下面的格式,使用简单的正则表达式即可解析。
根据 Kindle 设置的语言,中文与英文的格式会稍有不同,需要做不同的解析。
==========
娱乐至死 (尼尔·波兹曼)
- 您在位置 #1882-1884的标注 | 添加于 2019年6月2日星期日 上午10:07:30
古希腊哲学家在2500年以前就说过,人常常以自己的形象塑造上帝。现在,电视政治又添了新招:那些想当上帝的人把自己塑造成观众期望的形象。
==========
娱乐至死 (尼尔·波兹曼)
- 您在位置 #1925-1927的标注 | 添加于 2019年6月2日星期日 上午10:11:09
历史的消失根本不需要如此残酷的手段,表面温和的现代技术通过为民众提供一种政治形象、瞬间快乐和安慰疗法,能够同样有效地让历史销声匿迹,也许还更恒久,并且不会遭到任何反对。
==========
娱乐至死 (尼尔·波兹曼)
- 您在位置 #1961-1963的标注 | 添加于 2019年6月2日星期日 上午10:14:42
自由不是靠关掉电视实现的。电视对于大多数人来说,是生活中最有吸引力的东西。我们生活在一个绝大多数人不会关掉电视的世界里。如果我们不直接从电视得到某种信息,我们也会通过其他人得到它。
==========
配置 manifest.json
发布 Chrome 应用需要配置 manifest.json 。
更多设置可以查看开发文档
{
"name": "My Clippings", // 扩展名
"short_name": "Clippings",
"description": "Organizing your Kindle Highlight、Bookmark and Notes so easy.", // 描述
"version": "0.0.6", // 版本号,每次提交到 chrome 应用中心
"version_name": "0.0.6",
"manifest_version": 2,
"author": "Steve Xu",
"browser_action": {
// 点击应用图标的操作
"default_icon": "icon-48.png",
"default_title": "My Clippings"
},
"homepage_url": "https://github.com/nusr/my-clippings",
"offline_enabled": true, // 允许离线运行
"permissions": ["activeTab", "tabs", "storage"], // 使用的 chrome 权限
"icons": {
// 图标
"16": "icon-16.png",
"32": "icon-32.png",
"48": "icon-48.png",
"64": "icon-64.png",
"128": "icon-128.png",
"200": "icon-200.png"
},
"content_security_policy": "script-src 'self'; object-src 'self';", // 允许加载的文件
"background": {
"scripts": ["background.js"], // 外部运行的 js
"persistent": false
}
}
// background.js
// 点击扩展图标,打开新的 Tag 页面
function activeNewTab() {
var chrome = window.chrome;
if (!chrome) {
return;
}
chrome.browserAction.onClicked.addListener(function() {
var url = chrome.extension.getURL("index.html");
if (window.tabId) {
chrome.tabs.update(window.tabId, { selected: true });
} else {
chrome.tabs.create({ url: url }, function(tab) {
window.tabId = tab.id;
});
}
});
chrome.tabs.onRemoved.addListener(function(tabId) {
if (tabId === window.tabId) {
window.tabId = null;
}
});
}
activeNewTab();
上传到 Chrome 网上应用商店
Chrome 网上应用商店上传地址是 https://chrome.google.com/webstore/developer/dashboard。
上传应用需要支付 5 美元的开发者费用。对于没有信用卡的人来说,淘宝可以找到相关代付途径,或者寻求朋友帮助。
支付完成就可以上传应用了,一个账号最多上传 20 个应用。