docrev 0.2.1 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.rev-dictionary +4 -0
- package/CHANGELOG.md +76 -0
- package/README.md +89 -0
- package/bin/rev.js +2126 -0
- package/completions/rev.bash +127 -0
- package/completions/rev.zsh +207 -0
- package/lib/build.js +12 -1
- package/lib/doi.js +6 -2
- package/lib/equations.js +29 -12
- package/lib/git.js +238 -0
- package/lib/grammar.js +290 -0
- package/lib/journals.js +605 -0
- package/lib/merge.js +365 -0
- package/lib/scientific-words.js +73 -0
- package/lib/spelling.js +350 -0
- package/lib/trackchanges.js +229 -0
- package/lib/variables.js +173 -0
- package/lib/word.js +225 -0
- package/package.json +80 -2
- package/skill/REFERENCE.md +279 -0
- package/skill/SKILL.md +137 -0
- package/types/index.d.ts +525 -0
- package/CLAUDE.md +0 -75
package/.rev-dictionary
ADDED
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to docrev will be documented in this file.
|
|
4
|
+
|
|
5
|
+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
|
+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
|
+
|
|
8
|
+
## [0.3.2] - 2024-12-29
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
- Full TypeScript type definitions (`types/index.d.ts`)
|
|
12
|
+
- GitHub Actions CI workflow (Node 18/20/22)
|
|
13
|
+
- ESM subpath exports for all library modules
|
|
14
|
+
- CLI integration tests (26 tests)
|
|
15
|
+
- Comprehensive test coverage: 419 tests across 18 modules
|
|
16
|
+
|
|
17
|
+
### Fixed
|
|
18
|
+
- DOI skip detection: `% no-doi` comments now correctly apply only to the next entry
|
|
19
|
+
|
|
20
|
+
### Changed
|
|
21
|
+
- Added `engines` field requiring Node.js >=18.0.0
|
|
22
|
+
- Updated README with badges (npm, CI, Node.js, License)
|
|
23
|
+
|
|
24
|
+
## [0.3.1] - 2024-12-28
|
|
25
|
+
|
|
26
|
+
### Fixed
|
|
27
|
+
- Equation extraction test assertions
|
|
28
|
+
- Minor bug fixes
|
|
29
|
+
|
|
30
|
+
## [0.3.0] - 2024-12-27
|
|
31
|
+
|
|
32
|
+
### Added
|
|
33
|
+
- DOI validation via Crossref and DataCite APIs (`rev doi check`)
|
|
34
|
+
- DOI lookup for missing entries (`rev doi lookup`)
|
|
35
|
+
- DOI fetch and add commands (`rev doi fetch`, `rev doi add`)
|
|
36
|
+
- Citation validation against bibliography (`rev citations`)
|
|
37
|
+
- LaTeX equation extraction (`rev equations list`)
|
|
38
|
+
- Word equation import OMML → LaTeX (`rev equations from-word`)
|
|
39
|
+
- Response letter generation (`rev response`)
|
|
40
|
+
- Journal validation profiles (`rev validate --journal`)
|
|
41
|
+
- Advanced figure/table reference patterns (Figs. 1-3, Fig. 1a-c)
|
|
42
|
+
|
|
43
|
+
### Changed
|
|
44
|
+
- Improved cross-reference pattern detection
|
|
45
|
+
- Enhanced Word import with better section splitting
|
|
46
|
+
|
|
47
|
+
## [0.2.1] - 2024-12-26
|
|
48
|
+
|
|
49
|
+
### Added
|
|
50
|
+
- Table of contents option (`rev build --toc`)
|
|
51
|
+
- CSV export for comments (`rev comments --export`)
|
|
52
|
+
- Anonymize command for blind review (`rev anonymize`)
|
|
53
|
+
- Formatting utilities (tables, boxes, spinners)
|
|
54
|
+
|
|
55
|
+
## [0.2.0] - 2024-12-25
|
|
56
|
+
|
|
57
|
+
### Added
|
|
58
|
+
- Integrated build system (`rev build pdf/docx/tex`)
|
|
59
|
+
- Comment reply functionality (`rev reply`)
|
|
60
|
+
- Word document bootstrap (`rev import` creates project from .docx)
|
|
61
|
+
- Section-aware import (`rev sections`)
|
|
62
|
+
- Cross-reference migration (`rev migrate`)
|
|
63
|
+
|
|
64
|
+
### Changed
|
|
65
|
+
- Renamed project to docrev
|
|
66
|
+
- Published to npm
|
|
67
|
+
|
|
68
|
+
## [0.1.0] - 2024-12-24
|
|
69
|
+
|
|
70
|
+
### Added
|
|
71
|
+
- Initial release
|
|
72
|
+
- CriticMarkup annotation parsing
|
|
73
|
+
- Word ↔ Markdown round-trips
|
|
74
|
+
- Interactive review TUI (`rev review`)
|
|
75
|
+
- Comment management (`rev comments`, `rev resolve`)
|
|
76
|
+
- Project templates (`rev new`)
|
package/README.md
CHANGED
|
@@ -1,6 +1,9 @@
|
|
|
1
1
|
# docrev
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/docrev)
|
|
4
|
+
[](https://github.com/gcol33/docrev/actions/workflows/ci.yml)
|
|
5
|
+
[](https://nodejs.org/)
|
|
6
|
+
[](https://opensource.org/licenses/MIT)
|
|
4
7
|
|
|
5
8
|
CLI tool for Word ↔ Markdown round-trips. Handle reviewer feedback on academic papers: import track changes, review interactively, manage comments, validate DOIs, and build to PDF/DOCX/LaTeX.
|
|
6
9
|
|
|
@@ -35,6 +38,18 @@ rev --version
|
|
|
35
38
|
rev install # Check for missing dependencies
|
|
36
39
|
```
|
|
37
40
|
|
|
41
|
+
### Shell Completions (Optional)
|
|
42
|
+
|
|
43
|
+
Enable tab completion for `rev` commands:
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
# Bash - add to ~/.bashrc
|
|
47
|
+
eval "$(rev completions bash)"
|
|
48
|
+
|
|
49
|
+
# Zsh - add to ~/.zshrc
|
|
50
|
+
eval "$(rev completions zsh)"
|
|
51
|
+
```
|
|
52
|
+
|
|
38
53
|
## Features
|
|
39
54
|
|
|
40
55
|
- **Integrated build system** - Combine sections → paper.md → PDF, DOCX, or LaTeX
|
|
@@ -118,6 +133,7 @@ rev build docx
|
|
|
118
133
|
|---------|-------------|
|
|
119
134
|
| `rev build [formats...]` | Build PDF/DOCX/TEX from sections |
|
|
120
135
|
| `rev build --toc` | Build with table of contents |
|
|
136
|
+
| `rev build --show-changes` | Export DOCX with visible track changes |
|
|
121
137
|
| `rev new <name>` | Create new project from template |
|
|
122
138
|
| `rev new --list` | List available templates |
|
|
123
139
|
| `rev install` | Check/install dependencies (pandoc-crossref) |
|
|
@@ -176,6 +192,16 @@ rev build docx
|
|
|
176
192
|
| `rev equations from-word <docx>` | Extract equations from Word to LaTeX |
|
|
177
193
|
| `rev response [files]` | Generate response letter from comments |
|
|
178
194
|
| `rev anonymize <file>` | Prepare document for blind review |
|
|
195
|
+
| `rev validate --journal <name>` | Check manuscript against journal requirements |
|
|
196
|
+
| `rev validate --list` | List available journal profiles |
|
|
197
|
+
|
|
198
|
+
### Multi-Reviewer & Git
|
|
199
|
+
|
|
200
|
+
| Command | Description |
|
|
201
|
+
|---------|-------------|
|
|
202
|
+
| `rev merge <md> <docx...>` | Merge feedback from multiple Word documents |
|
|
203
|
+
| `rev diff [ref]` | Compare sections against git history |
|
|
204
|
+
| `rev history [file]` | Show revision history for sections |
|
|
179
205
|
|
|
180
206
|
### Configuration
|
|
181
207
|
|
|
@@ -185,6 +211,48 @@ rev build docx
|
|
|
185
211
|
| `rev split <file>` | Split annotated paper.md back to section files |
|
|
186
212
|
| `rev help [topic]` | Show help (topics: workflow, syntax, commands) |
|
|
187
213
|
|
|
214
|
+
### Convenience Commands
|
|
215
|
+
|
|
216
|
+
| Command | Description |
|
|
217
|
+
|---------|-------------|
|
|
218
|
+
| `rev word-count` | Show word counts per section |
|
|
219
|
+
| `rev word-count -j <journal>` | Warn if over journal word limit |
|
|
220
|
+
| `rev stats` | Project dashboard (words, figures, citations) |
|
|
221
|
+
| `rev search <query>` | Search across all section files |
|
|
222
|
+
| `rev backup` | Create timestamped backup zip |
|
|
223
|
+
| `rev export` | Export project as distributable zip |
|
|
224
|
+
| `rev preview <format>` | Build and open document |
|
|
225
|
+
| `rev watch [format]` | Auto-rebuild on file changes |
|
|
226
|
+
| `rev lint` | Check for broken refs, missing citations |
|
|
227
|
+
|
|
228
|
+
### Grammar & Style
|
|
229
|
+
|
|
230
|
+
| Command | Description |
|
|
231
|
+
|---------|-------------|
|
|
232
|
+
| `rev grammar` | Check grammar/style issues |
|
|
233
|
+
| `rev grammar --rules` | List available grammar rules |
|
|
234
|
+
| `rev grammar --learn <word>` | Add word to custom dictionary |
|
|
235
|
+
| `rev grammar --list` | Show custom dictionary |
|
|
236
|
+
|
|
237
|
+
### Spelling
|
|
238
|
+
|
|
239
|
+
| Command | Description |
|
|
240
|
+
|---------|-------------|
|
|
241
|
+
| `rev spelling` | Check spelling in all sections |
|
|
242
|
+
| `rev spelling --british` | Use British English dictionary |
|
|
243
|
+
| `rev spelling --learn <word>` | Add word to global dictionary |
|
|
244
|
+
| `rev spelling --learn-project <word>` | Add word to project dictionary |
|
|
245
|
+
| `rev spelling --list` | Show global dictionary |
|
|
246
|
+
| `rev spelling --list-all` | Show global + project dictionaries |
|
|
247
|
+
|
|
248
|
+
### Direct DOCX Editing
|
|
249
|
+
|
|
250
|
+
| Command | Description |
|
|
251
|
+
|---------|-------------|
|
|
252
|
+
| `rev annotate <docx>` | Add comments to Word document |
|
|
253
|
+
| `rev apply <md> <docx>` | Apply annotations as track changes |
|
|
254
|
+
| `rev comment <docx>` | Interactive comment mode |
|
|
255
|
+
|
|
188
256
|
## Project Structure
|
|
189
257
|
|
|
190
258
|
A typical rev project:
|
|
@@ -249,6 +317,27 @@ docx:
|
|
|
249
317
|
{>>Author: comment<<} # Comments
|
|
250
318
|
```
|
|
251
319
|
|
|
320
|
+
## Template Variables
|
|
321
|
+
|
|
322
|
+
Use template variables in section files (processed during build):
|
|
323
|
+
|
|
324
|
+
```markdown
|
|
325
|
+
Last updated: {{date}}
|
|
326
|
+
Version: {{version}}
|
|
327
|
+
Word count: {{word_count}}
|
|
328
|
+
```
|
|
329
|
+
|
|
330
|
+
| Variable | Description |
|
|
331
|
+
|----------|-------------|
|
|
332
|
+
| `{{date}}` | Current date (YYYY-MM-DD) |
|
|
333
|
+
| `{{date:MMMM D, YYYY}}` | Custom format (December 29, 2025) |
|
|
334
|
+
| `{{year}}` | Current year |
|
|
335
|
+
| `{{version}}` | Version from rev.yaml |
|
|
336
|
+
| `{{title}}` | Document title |
|
|
337
|
+
| `{{author}}` | First author name |
|
|
338
|
+
| `{{authors}}` | All authors (comma-separated) |
|
|
339
|
+
| `{{word_count}}` | Total word count |
|
|
340
|
+
|
|
252
341
|
## Comment Replies
|
|
253
342
|
|
|
254
343
|
Reply to reviewer comments with your name:
|