Skip to content

Commit 1c37cc3

Browse files
committed
init
1 parent 329da6a commit 1c37cc3

File tree

14 files changed

+6608
-0
lines changed

14 files changed

+6608
-0
lines changed

.gitignore

Lines changed: 132 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,132 @@
1+
# Logs
2+
logs
3+
*.log
4+
npm-debug.log*
5+
yarn-debug.log*
6+
yarn-error.log*
7+
lerna-debug.log*
8+
.pnpm-debug.log*
9+
10+
# Diagnostic reports (https://nodejs.org/api/report.html)
11+
report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
12+
13+
# Runtime data
14+
pids
15+
*.pid
16+
*.seed
17+
*.pid.lock
18+
19+
# Directory for instrumented libs generated by jscoverage/JSCover
20+
lib-cov
21+
22+
# Coverage directory used by tools like istanbul
23+
coverage
24+
*.lcov
25+
26+
# nyc test coverage
27+
.nyc_output
28+
29+
# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
30+
.grunt
31+
32+
# Bower dependency directory (https://bower.io/)
33+
bower_components
34+
35+
# node-waf configuration
36+
.lock-wscript
37+
38+
# Compiled binary addons (https://nodejs.org/api/addons.html)
39+
build/Release
40+
41+
# Dependency directories
42+
node_modules/
43+
jspm_packages/
44+
45+
# Snowpack dependency directory (https://snowpack.dev/)
46+
web_modules/
47+
48+
# TypeScript cache
49+
*.tsbuildinfo
50+
51+
# Optional npm cache directory
52+
.npm
53+
54+
# Optional eslint cache
55+
.eslintcache
56+
57+
# Optional stylelint cache
58+
.stylelintcache
59+
60+
# Microbundle cache
61+
.rpt2_cache/
62+
.rts2_cache_cjs/
63+
.rts2_cache_es/
64+
.rts2_cache_umd/
65+
66+
# Optional REPL history
67+
.node_repl_history
68+
69+
# Output of 'npm pack'
70+
*.tgz
71+
72+
# Yarn Integrity file
73+
.yarn-integrity
74+
75+
# dotenv environment variable files
76+
.env
77+
.env.development.local
78+
.env.test.local
79+
.env.production.local
80+
.env.local
81+
82+
# parcel-bundler cache (https://parceljs.org/)
83+
.cache
84+
.parcel-cache
85+
86+
# Next.js build output
87+
.next
88+
out
89+
90+
# Nuxt.js build / generate output
91+
.nuxt
92+
dist
93+
94+
# Gatsby files
95+
.cache/
96+
# Comment in the public line in if your project uses Gatsby and not Next.js
97+
# https://nextjs.org/blog/next-9-1#public-directory-support
98+
# public
99+
100+
# vuepress build output
101+
.vuepress/dist
102+
103+
# vuepress v2.x temp and cache directory
104+
.temp
105+
.cache
106+
107+
# Docusaurus cache and generated files
108+
.docusaurus
109+
110+
# Serverless directories
111+
.serverless/
112+
113+
# FuseBox cache
114+
.fusebox/
115+
116+
# DynamoDB Local files
117+
.dynamodb/
118+
119+
# TernJS port file
120+
.tern-port
121+
122+
# Stores VSCode versions used for testing VSCode extensions
123+
.vscode-test
124+
125+
# yarn v2
126+
.yarn/cache
127+
.yarn/unplugged
128+
.yarn/build-state.yml
129+
.yarn/install-state.gz
130+
.pnp.*
131+
132+
.idea
106 KB
Loading
184 KB
Loading
60.2 KB
Loading

README.md

Lines changed: 99 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
# UserScript Template
2+
3+
# 一、这是什么
4+
5+
使用`NodeJS`+`WebPack`开发油猴脚本的方案,用于提升油猴开发体验,一个`JavaScript`文件几千行来回改本人真的有点顶不住......
6+
7+
# 二、如何使用
8+
9+
在当前仓库选择“Use this template” --> “Create a new repository”,创建一个新的仓库:
10+
11+
![image-20230816233501101](README.assets/image-20230816233501101.png)
12+
13+
选择存放的位置以及设置仓库名字等等:
14+
15+
![image-20230816235634094](README.assets/image-20230816235634094.png)
16+
17+
仓库创建好了之后修改`package.json`文件,把相关字段替换为你自己的,比如名字、作者、仓库地址等等:
18+
19+
```js
20+
{
21+
"name": "userscript-foo",
22+
"version": "0.0.1",
23+
"main": "index.js",
24+
"repository": "https://github.com/JSREI/userscript-template.git",
25+
"scripts": {
26+
// ...
27+
},
28+
"author": "CC11001100 <[email protected]>",
29+
"license": "MIT",
30+
"devDependencies": {
31+
//...
32+
}
33+
}
34+
```
35+
36+
`userscript-headers.js`文件中存放的是默认的油猴头文件:
37+
38+
```
39+
// ==UserScript==
40+
// @name ${name}
41+
// @namespace ${repository}
42+
// @version ${version}
43+
// @description ${description}
44+
// @document ${document}
45+
// @author ${author}
46+
// @match *://*/*
47+
// @run-at document-start
48+
// ==/UserScript==
49+
```
50+
51+
`${name}`这种是支持的一些变量,在编译的时候会从`package.json`中获取对应的值替换掉。
52+
53+
然后就可以开心的写代码了,当你需要测试的时候,执行:
54+
55+
```bash
56+
npm run watch
57+
```
58+
59+
然后把`./dist/index.js`中的文件头复制到你的油猴中:
60+
61+
![image-20230817000716664](README.assets/image-20230817000716664.png)
62+
63+
并在最后添加一行引入编译后的文件:
64+
65+
```js
66+
// @require file://D:/workspace/userscript-template/dist/index.js
67+
```
68+
69+
比如一个开发时使用的油猴脚本的例子,油猴中不实际配置内容,而是使用require指向我们build后的文件,这样当修改完代码热加载编译的时候浏览器中引用的JS也是最新的:
70+
71+
```js
72+
// ==UserScript==
73+
// @name userscript-foo
74+
// @namespace https://github.com/JSREI/userscript-template.git
75+
// @version 0.0.1
76+
// @description
77+
// @document
78+
// @author CC11001100 <[email protected]>
79+
// @match *://*/*
80+
// @run-at document-start
81+
// @require file://D:/workspace/userscript-template/dist/index.js
82+
// ==/UserScript==
83+
(() => {})();
84+
```
85+
86+
当你需要发布的时候:
87+
88+
```bash
89+
npm run build
90+
```
91+
92+
然后把`./dist/index.js`文件拿去发布即可。
93+
94+
95+
96+
97+
98+
99+

0 commit comments

Comments
 (0)