cortav  Check-in [7b6c406de4]

Overview
Comment:update docs
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA3-256: 7b6c406de4e3786701c1dd6cbc709c5341eb67381d4f0b1b595535b6fbc86dda
User & Date: lexi on 2022-09-09 01:39:52
Other Links: manifest | tags
Context
2022-09-09
19:04
enable basic ID interpolation check-in: 8b33bc074d user: lexi tags: trunk
01:39
update docs check-in: 7b6c406de4 user: lexi tags: trunk
01:12
many fixes and updates to kate syntax check-in: 6c198bdce0 user: lexi tags: trunk
Changes

Modified cortav.ct from [3240d0f3f3] to [718eb3ed50].

   102    102   ** [`~~~ \[language\] title ~~~]
   103    103   ** [`~~~ title \[language\] #id ~~~]
   104    104   *[*reference] (tab): a line beginning with a tab is treated as a "reference." references hold out-of-line metadata for preceding text like links and footnotes. a reference consists of an identifier followed by a colon and an arbitrary number of spaces or tabs, followed by text. whether this text is interpreted as raw-text or styled-text depends on the context in which the reference is used. in encodings without tab characters, two preceding blanks can be used instead.
   105    105   * [*quotation] ([`<]): a line of the form [`<[$name]> [$quote]] denotes an utterance by [$name].
   106    106   * [*blockquote] ([`>]): alternate blockquote syntax. can be nested by repeating the [`>] character.
   107    107   * [*subtitle/caption] ([`\--]): attaches a subtitle to the previous header, or caption to the previous object
   108    108   * [*embed] ([`&]): embeds a referenced object. can be used to show images or repeat previously defined objects like lists or tables, optionally with a caption.
   109         -** [`&$[$macro] [$arg1]|[$arg2]|[$argn]…] invokes a block-level macro with the supplied arguments
   110         -*** [`&$mymacro arg 1|arg 2|arg 3]
          109  +** [`$[$macro] [$arg1]|[$arg2]|[$argn]…] invokes a block-level macro with the supplied arguments
          110  +*** [`$mymacro arg 1|arg 2|arg 3]
   111    111   ** [`&[$image]] embeds an image or other block-level object. [!image] can be a reference with a url or file path, or it can be an embed section (e.g. for SVG files)
   112    112   ***[`&myimg All that remained of the unfortunate blood magic pageant contestants and audience (police photo)]
   113    113   ** [`&-[$ident] [$styled-text]] embeds a closed disclosure element containing the text of the named object (a nonprinting section or cortav resource should usually be used to store the content; it can also name an image or video, of course). in interactive outputs, this will display as a block which can be clicked on to view the full contents of the referenced object [$ident]; if [$styled-text] is present, it overrides the title of the section you are embedding (if any). in static outputs, the disclosure object will display as an enclosed box with [$styled-text] as the title text
   114    114   *** [`&-ex-a Prosecution Exhibit A (GRAPHIC CONTENT)]
   115    115   ** [`&+[$section] [$styled-text]] is like the above, but the disclosure element is open by default
   116    116   * [*horizontal rule] ([`\---]): inserts a horizontal rule or other context break; does not end the section. must be followed by newline. underlines can also be used in place of dashes ([`___], [`-_-], [`__-__-__] etc), as can horizontal unicode box drawing characters ([`─ ━ ┈] etc).
   117    117   * [*page break] ([`\^^]): for formats that support pagination, like EPUB or HTML (when printed), indicates that the rest of the current page should be blank. for formats that do not, extra margins will be inserted. does not create a new section
................................................................................
   455    455   	cursive-quote: %font dup
   456    456   		%font set body=cursive
   457    457   		> [#1]
   458    458   		%font pop
   459    459   
   460    460   %% now, whenever we want a block with a cursive body, we can simply invoke
   461    461   
   462         -&$cursive-quote A sea of blood yet lies between us and the Destination. It won't impede me. And I'm so very proud to say that, apparently, it won't impede the Smiling Man either, if the Svalbard contract was any indication! [pause for laughter]
          462  +$cursive-quote A sea of blood yet lies between us and the Destination. It won't impede me. And I'm so very proud to say that, apparently, it won't impede the Smiling Man either, if the Svalbard contract was any indication! [pause for laughter]
   463    463   
   464    464   %% without affecting the overall font context. in fact, since 'cursive-quote' creates
   465    465   %% its context using 'dup', it would import all font specifications besides 'body'
   466    466   %% from the environment it is invoked in
   467    467   ~~~
   468    468   
   469    469   you may have noticed the rather odd bit at the end of our font definition, with the [`dit] URI. the reasons for this are tragic. groff, while delightful, has a thoroughly antiquated understanding of fonts, and doesn't support normal font formats like truetype. groff ships with a limited number of fonts in its own format, identified by obscurantist letter code ([`HBI] is "Helvetica Bold Italic", for instance) and lacking normal metadata. for this reason, you'll have to tell cortav how you want your fonts translated.

Modified desk/cortav.xml from [bf85cd3996] to [dc63948a6a].

     1      1   <?xml version='1.0' encoding='UTF-8'?>
     2      2   <!--
     3      3    [ʞ] cortav.xml
     4      4     ~ lexi hale <lexi@hale.su>
     5      5     © AGPLv3
     6      6     ? Kate/kwrite-compatible syntax definition for the cortav markup format
     7      7     > ln cortav.xml $HOME/.local/share/org.kde.syntax-highlighting/syntax/
            8  +  ! NOTE: the Kate syntax engine cannot capture all the syntactic properties
            9  +          of Cortav. we do the best we can, but note the following important
           10  +          discrepancies:
           11  +
           12  +            1) the inline resource syntax allows a wide range of complex
           13  +               brackets pairs such as <!--:[ ]:--!>; the Kate syntax only
           14  +               accounts for the pair { }
     8     15   -->
     9     16   <language name='Cortav' version='1' kateversion='2.4' section='Markup' extensions='*.ct'>
    10     17   	<highlighting>
    11     18   		<list name='extension-directives'>
    12     19   			<item>uses</item>
    13     20   			<item>needs</item>
    14     21   			<item>inhibits</item>