rolfedh-doc-utils 0.1.7__py3-none-any.whl → 0.1.8__py3-none-any.whl
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.
- {rolfedh_doc_utils-0.1.7.dist-info → rolfedh_doc_utils-0.1.8.dist-info}/METADATA +26 -4
- {rolfedh_doc_utils-0.1.7.dist-info → rolfedh_doc_utils-0.1.8.dist-info}/RECORD +6 -6
- {rolfedh_doc_utils-0.1.7.dist-info → rolfedh_doc_utils-0.1.8.dist-info}/WHEEL +0 -0
- {rolfedh_doc_utils-0.1.7.dist-info → rolfedh_doc_utils-0.1.8.dist-info}/entry_points.txt +0 -0
- {rolfedh_doc_utils-0.1.7.dist-info → rolfedh_doc_utils-0.1.8.dist-info}/licenses/LICENSE +0 -0
- {rolfedh_doc_utils-0.1.7.dist-info → rolfedh_doc_utils-0.1.8.dist-info}/top_level.txt +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: rolfedh-doc-utils
|
|
3
|
-
Version: 0.1.
|
|
3
|
+
Version: 0.1.8
|
|
4
4
|
Summary: CLI tools for AsciiDoc documentation projects
|
|
5
5
|
Author: Rolfe Dlugy-Hegwer
|
|
6
6
|
License: MIT License
|
|
@@ -54,7 +54,11 @@ These tools can modify or delete files. **Always:**
|
|
|
54
54
|
### Install with pipx (Recommended)
|
|
55
55
|
|
|
56
56
|
```bash
|
|
57
|
+
# Install
|
|
57
58
|
pipx install rolfedh-doc-utils
|
|
59
|
+
|
|
60
|
+
# Upgrade to latest version
|
|
61
|
+
pipx upgrade rolfedh-doc-utils
|
|
58
62
|
```
|
|
59
63
|
|
|
60
64
|
### Alternative Installation
|
|
@@ -71,18 +75,36 @@ pip install -e .
|
|
|
71
75
|
|
|
72
76
|
## 🛠️ Available Tools
|
|
73
77
|
|
|
78
|
+
**Note:** Commands use hyphens (`-`), while Python files use underscores (`_`). After installing with pipx, use the hyphenated commands directly.
|
|
79
|
+
|
|
74
80
|
| Tool | Description | Usage |
|
|
75
81
|
|------|-------------|-------|
|
|
76
|
-
| **`format-asciidoc-spacing`** | Standardizes spacing after headings and around includes | `format-asciidoc-spacing --dry-run
|
|
82
|
+
| **`format-asciidoc-spacing`** | Standardizes spacing after headings and around includes | `format-asciidoc-spacing --dry-run modules/` |
|
|
77
83
|
| **`check-scannability`** | Analyzes readability (sentence/paragraph length) | `check-scannability --max-words 25` |
|
|
78
|
-
| **`archive-unused-files`** | Finds and archives unreferenced .adoc files | `archive-unused-files --archive` |
|
|
79
|
-
| **`archive-unused-images`** | Finds and archives unreferenced images | `archive-unused-images --archive` |
|
|
84
|
+
| **`archive-unused-files`** | Finds and archives unreferenced .adoc files | `archive-unused-files` (preview)<br>`archive-unused-files --archive` (execute) |
|
|
85
|
+
| **`archive-unused-images`** | Finds and archives unreferenced images | `archive-unused-images` (preview)<br>`archive-unused-images --archive` (execute) |
|
|
80
86
|
| **`find-unused-attributes`** | Identifies unused attribute definitions | `find-unused-attributes attributes.adoc` |
|
|
81
87
|
|
|
82
88
|
## 📖 Documentation
|
|
83
89
|
|
|
84
90
|
Comprehensive documentation is available at **[rolfedh.github.io/doc-utils](https://rolfedh.github.io/doc-utils/)**
|
|
85
91
|
|
|
92
|
+
### OpenShift-docs Example
|
|
93
|
+
|
|
94
|
+
For OpenShift documentation repositories:
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
# Format spacing in specific directories
|
|
98
|
+
format-asciidoc-spacing modules/
|
|
99
|
+
format-asciidoc-spacing microshift_networking/
|
|
100
|
+
|
|
101
|
+
# Preview changes first
|
|
102
|
+
format-asciidoc-spacing --dry-run modules/networking/
|
|
103
|
+
|
|
104
|
+
# Process specific file
|
|
105
|
+
format-asciidoc-spacing modules/networking/about-networking.adoc
|
|
106
|
+
```
|
|
107
|
+
|
|
86
108
|
- [Getting Started Guide](https://rolfedh.github.io/doc-utils/getting-started)
|
|
87
109
|
- [Tools Reference](https://rolfedh.github.io/doc-utils/tools/)
|
|
88
110
|
- [Best Practices](https://rolfedh.github.io/doc-utils/best-practices)
|
|
@@ -10,9 +10,9 @@ doc_utils/topic_map_parser.py,sha256=tKcIO1m9r2K6dvPRGue58zqMr0O2zKU1gnZMzEE3U6o
|
|
|
10
10
|
doc_utils/unused_adoc.py,sha256=2cbqcYr1os2EhETUU928BlPRlsZVSdI00qaMhqjSIqQ,5263
|
|
11
11
|
doc_utils/unused_attributes.py,sha256=HBgmHelqearfWl3TTC2bZGiJytjLADIgiGQUNKqXXPg,1847
|
|
12
12
|
doc_utils/unused_images.py,sha256=nqn36Bbrmon2KlGlcaruNjJJvTQ8_9H0WU9GvCW7rW8,1456
|
|
13
|
-
rolfedh_doc_utils-0.1.
|
|
14
|
-
rolfedh_doc_utils-0.1.
|
|
15
|
-
rolfedh_doc_utils-0.1.
|
|
16
|
-
rolfedh_doc_utils-0.1.
|
|
17
|
-
rolfedh_doc_utils-0.1.
|
|
18
|
-
rolfedh_doc_utils-0.1.
|
|
13
|
+
rolfedh_doc_utils-0.1.8.dist-info/licenses/LICENSE,sha256=vLxtwMVOJA_hEy8b77niTkdmQI9kNJskXHq0dBS36e0,1075
|
|
14
|
+
rolfedh_doc_utils-0.1.8.dist-info/METADATA,sha256=KrjqTRhF_B26ZNt37SZXReMcV4-ztpy1aWHJepYxMDE,6891
|
|
15
|
+
rolfedh_doc_utils-0.1.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
|
|
16
|
+
rolfedh_doc_utils-0.1.8.dist-info/entry_points.txt,sha256=dA-u4qlxKcewUAOFgaeW1NUIrkhsVknuwFuGTn1-84w,271
|
|
17
|
+
rolfedh_doc_utils-0.1.8.dist-info/top_level.txt,sha256=WrYqTa4wbjRPMUl2hgJBfP734XsXLkhbnzUublx8S0s,119
|
|
18
|
+
rolfedh_doc_utils-0.1.8.dist-info/RECORD,,
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|