Update readme
This commit is contained in:
Northword
parent
d2d8922f66
commit
9c824d6faa
143
README.md
143
README.md
@ -7,22 +7,23 @@ This is a plugin template for [Zotero](https://www.zotero.org/).
|
|||||||
|
|
||||||
Plugins created with this template:
|
Plugins created with this template:
|
||||||
|
|
||||||
|
[](https://github.com/windingwind/zotero-better-notes)
|
||||||
|
[](https://github.com/windingwind/zotero-pdf-preview)
|
||||||
|
[](https://github.com/windingwind/zotero-pdf-translate)
|
||||||
|
[](https://github.com/windingwind/zotero-tag)
|
||||||
|
[](https://github.com/iShareStuff/ZoteroTheme)
|
||||||
|
[](https://github.com/MuiseDestiny/zotero-reference)
|
||||||
|
[](https://github.com/MuiseDestiny/zotero-citation)
|
||||||
|
[](https://github.com/MuiseDestiny/ZoteroStyle)
|
||||||
|
[](https://github.com/volatile-static/Chartero)
|
||||||
|
[](https://github.com/l0o0/tara)
|
||||||
|
[](https://github.com/redleafnew/delitemwithatt)
|
||||||
|
[](https://github.com/redleafnew/zotero-updateifsE)
|
||||||
|
[](https://github.com/northword/zotero-format-metadata)
|
||||||
|
[](https://github.com/inciteful-xyz/inciteful-zotero-plugin)
|
||||||
|
[](https://github.com/MuiseDestiny/zotero-gpt)
|
||||||
|
[](https://github.com/zoushucai/zotero-journalabbr)
|
||||||
|
[](https://github.com/MuiseDestiny/zotero-figure)
|
||||||
|
|
||||||
📖[Plugin Development Documentation](https://zotero.yuque.com/books/share/8d230829-6004-4934-b4c6-685a7001bfa0/vec88d)(Chinese, provides English translation)
|
📖[Plugin Development Documentation](https://zotero.yuque.com/books/share/8d230829-6004-4934-b4c6-685a7001bfa0/vec88d)(Chinese, provides English translation)
|
||||||
|
|
||||||
@ -181,7 +182,7 @@ npm run release
|
|||||||
|
|
||||||
### Setup Development Environment
|
### Setup Development Environment
|
||||||
|
|
||||||
1. Install a beta version of Zotero: https://www.zotero.org/support/beta_builds (Zotero 7 beta: https://www.zotero.org/support/dev/zotero_7_for_developers)
|
1. Install a beta version of Zotero: <https://www.zotero.org/support/beta_builds> (Zotero 7 beta: <https://www.zotero.org/support/dev/zotero_7_for_developers>)
|
||||||
|
|
||||||
2. Install Firefox 102(for Zotero 7)
|
2. Install Firefox 102(for Zotero 7)
|
||||||
|
|
||||||
@ -239,7 +240,7 @@ You can also:
|
|||||||
- Test code snipastes in Tools->Developer->Run Javascript;
|
- Test code snipastes in Tools->Developer->Run Javascript;
|
||||||
- Debug output with `Zotero.debug()`. Find the outputs in Help->Debug Output Logging->View Output;
|
- Debug output with `Zotero.debug()`. Find the outputs in Help->Debug Output Logging->View Output;
|
||||||
- Debug UI. Zotero is built on the Firefox XUL framework. Debug XUL UI with software like [XUL Explorer](https://udn.realityripple.com/docs/Archive/Mozilla/XUL_Explorer).
|
- Debug UI. Zotero is built on the Firefox XUL framework. Debug XUL UI with software like [XUL Explorer](https://udn.realityripple.com/docs/Archive/Mozilla/XUL_Explorer).
|
||||||
> XUL Documentation: http://www.devdoc.net/web/developer.mozilla.org/en-US/docs/XUL.html
|
> XUL Documentation: <http://www.devdoc.net/web/developer.mozilla.org/en-US/docs/XUL.html>
|
||||||
|
|
||||||
## Details
|
## Details
|
||||||
|
|
||||||
@ -298,7 +299,7 @@ Steps in `scripts/build.js`:
|
|||||||
|
|
||||||
### About Zotero API
|
### About Zotero API
|
||||||
|
|
||||||
Zotero docs are outdated and incomplete. Clone https://github.com/zotero/zotero and search the keyword globally.
|
Zotero docs are outdated and incomplete. Clone <https://github.com/zotero/zotero> and search the keyword globally.
|
||||||
|
|
||||||
> ⭐The [zotero-types](https://github.com/windingwind/zotero-types) provides most frequently used Zotero APIs. It's included in this template by default. Your IDE would provide hint for most of the APIs.
|
> ⭐The [zotero-types](https://github.com/windingwind/zotero-types) provides most frequently used Zotero APIs. It's included in this template by default. Your IDE would provide hint for most of the APIs.
|
||||||
|
|
||||||
@ -319,56 +320,66 @@ This section shows the directory structure of a template.
|
|||||||
> Don't break the lines in the `defaults.js`
|
> Don't break the lines in the `defaults.js`
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
│ .gitignore
|
.
|
||||||
│ .release-it.json # release-it conf
|
|-- .eslintrc.json # eslint conf
|
||||||
| tsconfig.json # https://code.visualstudio.com/docs/languages/jsconfig#
|
|-- .gitattributes # git conf
|
||||||
│ build.js # esbuild
|
|-- .github/ # github conf
|
||||||
│ LICENSE
|
|-- .gitignore # git conf
|
||||||
│ package.json # npm conf
|
|-- .prettierrc # prettier conf
|
||||||
│ README.md # readme
|
|-- .release-it.json # release-it conf
|
||||||
│ update.rdf # addon update
|
|-- .vscode # vs code conf
|
||||||
│
|
| |-- extensions.json
|
||||||
├─.github # github conf
|
| |-- launch.json
|
||||||
│
|
| |-- setting.json
|
||||||
├─addon # addon dir
|
| `-- toolkit.code-snippets
|
||||||
│ │ manifest.json # addon config
|
|-- package-lock.json # npm conf
|
||||||
│ │ bootstrap.js # addon load/unload script, like a main.c
|
|-- package.json # npm conf
|
||||||
│ │
|
|-- LICENSE
|
||||||
│ └─chrome
|
|-- README.md
|
||||||
│ ├─content # UI
|
|-- addon
|
||||||
│ │ │ preferences.xhtml
|
| |-- bootstrap.js # addon load/unload script, like a main.c
|
||||||
│ │ │
|
| |-- chrome
|
||||||
│ │ ├─icons
|
| | `-- content
|
||||||
│ │ │ favicon.png
|
| | |-- icons/
|
||||||
│ │ │ favicon@0.5x.png
|
| | |-- preferences.xhtml # preference panel
|
||||||
│ │ │
|
| | `-- zoteroPane.css
|
||||||
│ │ └─scripts
|
| |-- locale # locale
|
||||||
│ └─locale # locale
|
| | |-- en-US
|
||||||
│ ├─en-US
|
| | | |-- addon.ftl
|
||||||
│ │ overlay.dtd
|
| | | `-- preferences.ftl
|
||||||
│ │ addon.properties
|
| | `-- zh-CN
|
||||||
│ │
|
| | |-- addon.ftl
|
||||||
│ ├─zh-CN
|
| | `-- preferences.ftl
|
||||||
│ | overlay.dtd
|
| |-- manifest.json # addon config
|
||||||
│ └─ addon.properties
|
| `-- prefs.js
|
||||||
│
|
|-- builds/ # build dir
|
||||||
├─builds # build dir
|
|-- scripts # scripts for dev
|
||||||
│ └─.xpi
|
| |-- build.mjs # esbuild and replace
|
||||||
│
|
| |-- reload.mjs
|
||||||
└─src # source code
|
| |-- start.mjs
|
||||||
│ index.ts # main entry
|
| |-- stop.mjs
|
||||||
│ addon.ts # base class
|
| `-- zotero-cmd-default.json
|
||||||
│ hooks.ts # lifecycle hooks
|
|-- src # source code
|
||||||
|
|
| |-- addon.ts # base class
|
||||||
└─modules # sub modules
|
| |-- hooks.ts # lifecycle hooks
|
||||||
│ examples.ts # examples factory
|
| |-- index.ts # main entry
|
||||||
│ locale.ts # locale .properties
|
| |-- modules # sub modules
|
||||||
│ preferenceScript.ts # script runs in preferences.xhtml
|
| | |-- examples.ts
|
||||||
└─ progressWindow.ts # progressWindow tool
|
| | `-- preferenceScript.ts
|
||||||
|
| `-- utils # utilities
|
||||||
|
| |-- locale.ts
|
||||||
|
| |-- prefs.ts
|
||||||
|
| |-- wait.ts
|
||||||
|
| `-- window.ts
|
||||||
|
|-- tsconfig.json # https://code.visualstudio.com/docs/languages/jsconfig
|
||||||
|
|-- typings # ts typings
|
||||||
|
| `-- global.d.ts
|
||||||
|
|-- update-template.json # template of `update.json`
|
||||||
|
`-- update.json
|
||||||
```
|
```
|
||||||
|
|
||||||
## Disclaimer
|
## Disclaimer
|
||||||
|
|
||||||
Use this code under AGPL. No warranties are provided. Keep the laws of your locality in mind!
|
Use this code under AGPL. No warranties are provided. Keep the laws of your locality in mind!
|
||||||
|
|
||||||
If you want to change the license, please contact me at wyzlshx@foxmail.com
|
If you want to change the license, please contact me at <wyzlshx@foxmail.com>
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user