lethosor
e9eeb5fda0
tool_docs: don't assume cwd is dfhack root
...
hopefully fixes the CI docs build in dfhack/scripts
2022-09-24 14:00:04 -04:00
myk002
50f0d11372
include tool desc in the index for all formats
2022-09-23 13:19:13 -07:00
myk002
4ae1b7fb74
fix anchor text transformation
2022-09-23 12:51:50 -07:00
myk002
98b6ad4954
fix index titles on pdf
2022-09-23 12:34:50 -07:00
myk002
1cd5e8657a
link directly to the tool page title
...
instead of the top of the page
this is especially important on mobile where the top of the page is
taken up with the sidebar boilerplate
2022-09-23 11:33:14 -07:00
myk002
52011bde7b
share tag list between tool and commands
...
so all relevant tag index entries get generated
2022-09-23 11:13:49 -07:00
myk002
5869ba64c8
add tag description to the tag index page
...
this is a terrible hack that only works because sphinx doesn't sanitize
its input for the html builder. we set the title to
'%s<h4>%s</h4>' % (tag, desc)
so the final html looks like <h1>adventure<h4>...</h4></h1>
this may not play nice with the pdf builder..
2022-09-23 10:21:53 -07:00
myk002
1b9cd83009
use a domain index instead of the genindex
2022-09-23 10:10:28 -07:00
myk002
a92e5d1f74
populate, merge, and generate real tag indices
2022-09-23 09:32:08 -07:00
myk002
a1d3fe77b5
add a bit more index infrastructure
2022-09-23 08:46:50 -07:00
myk002
278b7528ac
implement basic domain index structure
2022-09-23 08:46:50 -07:00
Myk Taylor
35152bf022
create genindex entries for all tools and commands
2022-09-21 10:12:30 -07:00
lethosor
c1154085cf
Fix tool name auto-detection for scripts in subfolders
2022-09-15 23:03:34 -04:00
myk002
25c99b5d1f
make summary text easier to read in text mode
2022-08-25 21:46:23 -07:00
lethosor
72de1873e0
Improve keybinding rendering under the text builder
...
Previously rendered as e.g. "CtrlShiftK"
2022-08-17 23:18:58 -04:00
lethosor
fa8bceba93
Make paragraph labels render as plain text (not bold) under the text builder
2022-08-17 23:17:08 -04:00
lethosor
a4e70cf3e1
Remove now-unused dfhack-keybind role
2022-08-17 22:56:06 -04:00
lethosor
7e0581204d
Refactor everything to use make_labeled_paragraph()
2022-08-17 22:37:03 -04:00
myk002
83e1fa7de0
add summary text in its own paragraph element
2022-08-16 00:12:25 -07:00
myk002
b01ef4a962
add todos about not using strong for text output
2022-08-15 23:14:16 -07:00
myk002
f9930b313a
migrate all docs to the new directives
...
add a summary option for tools and commands so we can output them with
their tags and keybindings at the top of the file.
2022-08-09 22:37:24 -07:00
lethosor
2d60c543fd
Remove "Tool:" line
2022-08-08 21:22:55 -04:00
lethosor
daf3bc516b
Switch to <topic> to fix line breaks in text output
...
No visible change in HTML output; PDF looks different but still acceptable
2022-08-08 17:32:42 -04:00
lethosor
6e29ddf2d3
Move space out of <strong> node for better text rendering
2022-08-08 17:32:42 -04:00
lethosor
6b32e008b3
Attempt to port keybinding documentation verification to new extension
...
Likely requires a sphinx Domain to work with parallel builds properly
2022-08-08 17:32:42 -04:00
lethosor
7651d301d2
Remove extra paragraph around keybindings
2022-08-08 17:32:41 -04:00
lethosor
ed95db27f5
Move dfhack-keybind role to tool_docs.py and call from dfhack-command
2022-08-08 17:30:19 -04:00
lethosor
5ef36d210f
Render implicit dfhack-command alongside dfhack-tool unless :no-command: is passed
2022-08-08 17:30:19 -04:00
lethosor
39e9288458
Render commands as literals
2022-08-08 17:30:18 -04:00
lethosor
b3d79f87cb
Fix optional name override
2022-08-08 17:30:18 -04:00
lethosor
d19ffa1806
Add stub dfhack-command directive, refactor to support
2022-08-08 17:30:18 -04:00
lethosor
12b3363b2c
Make dfhack-tool tags link to tag descriptions
2022-08-08 17:30:18 -04:00
lethosor
bb2ca0cc16
Render dfhack-tool as admonition
...
Getting a section header integrated is complicated, so might as well emulate
Mediawiki with a box-like element instead
2022-08-08 17:30:17 -04:00
lethosor
de5f4d3566
Default to document basename in dfhack-tool directive
2022-08-08 17:30:17 -04:00
lethosor
89a88e94a9
Allow empty :tags:, give section a name to prevent errors
2022-08-08 17:30:17 -04:00
lethosor
d96260556e
Make title visible by putting it in its own section
2022-08-08 17:30:16 -04:00
lethosor
c44c8721c9
Initial attempt at dfhack-tool directive
...
Doesn't appear to produce headings that can be used as link targets...
2022-08-08 17:30:16 -04:00