Mercurial > p > roundup > code
view doc/format_config.awk @ 8053:740c1c5d9ec4
docs: move first paragraph close to footnote return link
Footnotes used to look like:
[1]
first paragraph starts 1.2 em away because of default * + * spacing.
More paragraph lines. ...
It looks wrong. The return link should be closer to the first
paragraph so they are seen as more of a unit. Ideally the return link
'[1]' should be a hanging indent and all paragraphs for the footnote
should be indented. But I can't figure out how to do that. So tighten
up the space before the first paragraph.
[1]
So the first paragraph after the label starts right below it tying
the footnote to the text.
| author | John Rouillard <rouilj@ieee.org> |
|---|---|
| date | Tue, 02 Jul 2024 22:31:00 -0400 |
| parents | 8b5f8b950f58 |
| children | c3bf229d3d4b |
line wrap: on
line source
#! /bin/awk # delete first 8 lines NR < 9 {next} # When we see a section [label]: # emit section index marker, # emit section anchor # set up for code formating # emit any comments/blank line that are accumulated before the # section marker # print the indented section marker # # zero the accumulator and the variable that prevents large blocks # of empty lines. /^\[([a-z]*)\]/ { match($0, /^\[([a-z]*)\].*/, section_match); section = section_match[1]; print("\n\n.. index:: config.ini; sections " section); print(".. _`config-ini-section-" section "`:"); print(".. code:: ini\n"); if (accumulate) { print(" " accumulate "\n"); } print(" " $0); accumulate = ""; prev_line_is_blank = 0; } # if the line is a setting line (even if commented out) # print the accumulated comments/blank lines and the setting line # zero the accumulator and the variable that prevents blocks of blank lines # get the next input line /^#?[a-z0-9_-]* =/ { print accumulate "\n " $0; accumulate = ""; prev_line_is_blank = 0; next; } # accumulate comment lines and indent them /^#/ { accumulate = accumulate "\n " $0; prev_line_is_blank = 0;} # accumulate a blank line only if the previous line was not blank. /^$/ { if (! prev_line_is_blank) {accumulate = accumulate $0}; prev_line_is_blank = 1; }
