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.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: rolfedh-doc-utils
3
- Version: 0.1.7
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.7.dist-info/licenses/LICENSE,sha256=vLxtwMVOJA_hEy8b77niTkdmQI9kNJskXHq0dBS36e0,1075
14
- rolfedh_doc_utils-0.1.7.dist-info/METADATA,sha256=KZ9pa1ZFWS_rj4iVRW9TTbL6RPWvVFfL2twZseuk9Ko,6200
15
- rolfedh_doc_utils-0.1.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
16
- rolfedh_doc_utils-0.1.7.dist-info/entry_points.txt,sha256=dA-u4qlxKcewUAOFgaeW1NUIrkhsVknuwFuGTn1-84w,271
17
- rolfedh_doc_utils-0.1.7.dist-info/top_level.txt,sha256=WrYqTa4wbjRPMUl2hgJBfP734XsXLkhbnzUublx8S0s,119
18
- rolfedh_doc_utils-0.1.7.dist-info/RECORD,,
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,,