| name | Wikize Refs |
| description | Use when editing BSSw.io markdown files that need formal external citations/references, when converting inline external links into BSSw reference-style links, or when running `utils/wikize_refs.py` to regenerate or verify the auto-generated references block. |
Wikize Refs
Use this skill for BSSw.io *.md files that manage external references with utils/wikize_refs.py.
Canonical References
Read only what you need:
Compact Workflow
-
Inspect the target *.md file and confirm formal citations are warranted for this content type and article length.
-
Keep the author-managed source references as column-0 GFM reference definitions, usually near the end of the file above the auto-generated block:
[label]: URL "Short title {Full bibliographic text}"
-
In body text, cite with <sup>[label]</sup> or <sup>[label1],[label2]</sup>. Follow BSSw punctuation guidance and use straight quotes only in reference definitions.
-
Prefer DOI URLs when available. Use absolute URLs for external resources and relative .md links for BSSw internal content.
-
Do not hand-edit anything containing sfer-ezikiw or the generated ### References section. Regenerate it with the tool.
-
From the repo root, normally run:
./utils/wikize_refs.py -i path/to/file.md
Useful alternatives:
./utils/wikize_refs.py -o /tmp/file-gen.md path/to/file.md
./utils/wikize_refs.py -u path/to/file.md
./utils/wikize_refs.py --help
-
Review the diff. Expected results:
- inline
<sup>[label]</sup> citations rewritten to generated numeric refs such as <sup>[1]</sup>
- original link definitions renamed with
-sfer-ezikiw
- a generated
### References section appended
- rerunning the tool should be idempotent
-
-i creates file.md~ unless -s is used. Handle that backup intentionally and do not commit it by accident.
-
Before finalizing content for publishing, ensure the file has been rerun through wikize_refs.py -i.
Examples
Notes
- Avoid
-c/--check-links unless network access is intentionally available.
- The repo convention is to edit the human-authored references and rerun the tool, not to patch the generated block manually.