2019-03-17 14:40:57 +02:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
< html >
< head >
2020-04-14 19:56:54 +03:00
< title > Codename Roadsign< / title >
2020-03-19 02:11:25 +02:00
< meta name = "viewport" content = "width=device-width initial-scale=1" >
2019-03-17 14:40:57 +02:00
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" >
< meta http-equiv = "Content-Language" content = "en-gb" >
2020-03-19 02:11:25 +02:00
< link href = "../inweb.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
2020-04-14 19:56:54 +03:00
2019-03-17 14:40:57 +02:00
< / head >
< body >
2020-03-19 02:11:25 +02:00
< nav role = "navigation" >
2020-04-14 19:56:54 +03:00
< h1 > < a href = "../index.html" >
< img src = "../docs-src/Figures/Inform.png" height = 72" >
< / a > < / h1 >
< ul > < li > < a href = "../compiler.html" > compiler tools< / a > < / li >
< li > < a href = "../other.html" > other tools< / a > < / li >
2020-03-19 02:11:25 +02:00
< li > < a href = "../extensions.html" > extensions and kits< / a > < / li >
< li > < a href = "../units.html" > unit test tools< / a > < / li >
2020-04-14 19:56:54 +03:00
< / ul > < h2 > Other Tools< / h2 > < ul >
2020-03-19 02:11:25 +02:00
< li > < a href = "../inblorb/index.html" > inblorb< / a > < / li >
2020-04-14 19:56:54 +03:00
< li > < a href = "index.html" > < span class = "selectedlink" > indoc< / span > < / a > < / li >
2020-03-19 02:11:25 +02:00
< li > < a href = "../inpolicy/index.html" > inpolicy< / a > < / li >
< li > < a href = "../inrtps/index.html" > inrtps< / a > < / li >
2020-04-14 19:56:54 +03:00
< / ul > < h2 > Foundation< / h2 > < ul >
2020-03-19 02:11:25 +02:00
< li > < a href = "../../../inweb/docs/foundation-module/index.html" > foundation< / a > < / li >
2020-04-14 19:56:54 +03:00
< / ul >
2020-03-19 02:11:25 +02:00
< / nav >
< main role = "main" >
2020-04-14 19:56:54 +03:00
<!-- Weave of 'Codename Roadsign' generated by 7 -->
< ul class = "crumbs" > < li > < a href = "../index.html" > Home< / a > < / li > < li > < a href = "../other.html" > Other Tools< / a > < / li > < li > < a href = "index.html" > indoc< / a > < / li > < li > < a href = "index.html#4" > Chapter 4: Navigation Styles< / a > < / li > < li > < b > Codename Roadsign< / b > < / li > < / ul > < p class = "purpose" > The "roadsign" style of navigational gadgets.< / p >
2019-03-17 14:40:57 +02:00
< ul class = "toc" > < li > < a href = "#SP1" > § 1. Creation< / a > < / li > < li > < a href = "#SP2" > § 2. Top< / a > < / li > < li > < a href = "#SP5" > § 5. Index top< / a > < / li > < li > < a href = "#SP6" > § 6. Middle< / a > < / li > < li > < a href = "#SP7" > § 7. Example top< / a > < / li > < li > < a href = "#SP8" > § 8. Utility routines< / a > < / li > < li > < a href = "#SP12" > § 12. Ecce romani< / a > < / li > < / ul > < hr class = "tocbar" >
< p class = "inwebparagraph" > < a id = "SP1" > < / a > < b > § 1. Creation. < / b > < / p >
< pre class = "display" >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > navigation_design< / span > < span class = "plain" > *< / span > < span class = "functiontext" > Roadsign::create< button class = "popup" onclick = "togglePopup('usagePopup168')" > ...< span class = "popuptext" id = "usagePopup168" > Usage of < b > Roadsign::create< / b > :< br > Navigational Designs - < a href = "4-nd.html#SP1" > § 1< / a > < / span > < / button > < / span > < span class = "plain" > (< / span > < span class = "reserved" > void< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > navigation_design< / span > < span class = "plain" > *< / span > < span class = "identifier" > ND< / span > < span class = "plain" > = < / span > < span class = "functiontext" > < a href = "4-nd.html#SP1" > Nav::new< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > I< / span > < span class = "string" > "roadsign"< / span > < span class = "plain" > , < / span > < span class = "constant" > TRUE< / span > < span class = "plain" > , < / span > < span class = "constant" > FALSE< / span > < span class = "plain" > );< / span >
< span class = "identifier" > METHOD_ADD< / span > < span class = "plain" > (< / span > < span class = "identifier" > ND< / span > < span class = "plain" > , < / span > < span class = "constant" > RENDER_VOLUME_TITLE_MTID< / span > < span class = "plain" > , < / span > < span class = "functiontext" > < a href = "#SP2" > Roadsign::roadsign_volume_title< / a > < / span > < span class = "plain" > );< / span >
< span class = "identifier" > METHOD_ADD< / span > < span class = "plain" > (< / span > < span class = "identifier" > ND< / span > < span class = "plain" > , < / span > < span class = "constant" > RENDER_CHAPTER_TITLE_MTID< / span > < span class = "plain" > , < / span > < span class = "functiontext" > < a href = "#SP3" > Roadsign::roadsign_chapter_title< / a > < / span > < span class = "plain" > );< / span >
< span class = "identifier" > METHOD_ADD< / span > < span class = "plain" > (< / span > < span class = "identifier" > ND< / span > < span class = "plain" > , < / span > < span class = "constant" > RENDER_SECTION_TITLE_MTID< / span > < span class = "plain" > , < / span > < span class = "functiontext" > < a href = "#SP4" > Roadsign::roadsign_section_title< / a > < / span > < span class = "plain" > );< / span >
< span class = "identifier" > METHOD_ADD< / span > < span class = "plain" > (< / span > < span class = "identifier" > ND< / span > < span class = "plain" > , < / span > < span class = "constant" > RENDER_INDEX_TOP_MTID< / span > < span class = "plain" > , < / span > < span class = "functiontext" > < a href = "#SP5" > Roadsign::roadsign_navigation_index_top< / a > < / span > < span class = "plain" > );< / span >
< span class = "identifier" > METHOD_ADD< / span > < span class = "plain" > (< / span > < span class = "identifier" > ND< / span > < span class = "plain" > , < / span > < span class = "constant" > RENDER_NAV_MIDDLE_MTID< / span > < span class = "plain" > , < / span > < span class = "functiontext" > < a href = "#SP6" > Roadsign::roadsign_navigation_middle< / a > < / span > < span class = "plain" > );< / span >
< span class = "identifier" > METHOD_ADD< / span > < span class = "plain" > (< / span > < span class = "identifier" > ND< / span > < span class = "plain" > , < / span > < span class = "constant" > RENDER_EXAMPLE_TOP_MTID< / span > < span class = "plain" > , < / span > < span class = "functiontext" > < a href = "#SP7" > Roadsign::roadsign_navigation_example_top< / a > < / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "identifier" > ND< / span > < span class = "plain" > ;< / span >
< span class = "plain" > }< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "inwebparagraph" > < a id = "SP2" > < / a > < b > § 2. Top. < / b > At the front end of a section, before any of its text.
< / p >
< pre class = "display" >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > void< / span > < span class = "plain" > < / span > < span class = "functiontext" > Roadsign::roadsign_volume_title< button class = "popup" onclick = "togglePopup('usagePopup169')" > ...< span class = "popuptext" id = "usagePopup169" > Usage of < b > Roadsign::roadsign_volume_title< / b > :< br > < a href = "#SP1" > § 1< / a > < / span > < / button > < / span > < span class = "plain" > (< / span > < span class = "reserved" > navigation_design< / span > < span class = "plain" > *< / span > < span class = "identifier" > self< / span > < span class = "plain" > , < / span > < span class = "reserved" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "reserved" > volume< / span > < span class = "plain" > *< / span > < span class = "identifier" > V< / span > < span class = "plain" > ) {< / span >
2019-03-17 14:40:57 +02:00
< < span class = "cwebmacro" > Render a volume heading< / span > < span class = "cwebmacronumber" > 2.1< / span > > < span class = "plain" > ;< / span >
< < span class = "cwebmacro" > Render a chapter-contents table< / span > < span class = "cwebmacronumber" > 2.2< / span > > < span class = "plain" > ;< / span >
< span class = "identifier" > HTML_OPEN< / span > < span class = "plain" > (< / span > < span class = "string" > "p"< / span > < span class = "plain" > ); < / span > < span class = "identifier" > HTML_CLOSE< / span > < span class = "plain" > (< / span > < span class = "string" > "p"< / span > < span class = "plain" > );< / span >
< < span class = "cwebmacro" > Render the volume-top roadsign< / span > < span class = "cwebmacronumber" > 2.3< / span > > < span class = "plain" > ;< / span >
< span class = "plain" > }< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "inwebparagraph" > < a id = "SP2_1" > < / a > < b > § 2.1. < / b > < code class = "display" >
< < span class = "cwebmacrodefn" > Render a volume heading< / span > < span class = "cwebmacronumber" > 2.1< / span > > =
< / code > < / p >
< pre class = "displaydefn" >
< span class = "identifier" > TEMPORARY_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > partn< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > no_volumes< / span > < span class = "plain" > > < / span > < span class = "constant" > 1< / span > < span class = "plain" > ) < / span > < span class = "functiontext" > < a href = "#SP12" > Roadsign::roman_numeral< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > partn< / span > < span class = "plain" > , < / span > < span class = "identifier" > V< / span > < span class = "plain" > -> < / span > < span class = "element" > allocation_id< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > HTML_OPEN_WITH< / span > < span class = "plain" > (< / span > < span class = "string" > "p"< / span > < span class = "plain" > , < / span > < span class = "string" > "class=\"volumeheading\""< / span > < span class = "plain" > );< / span >
< span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "%S%S"< / span > < span class = "plain" > , < / span > < span class = "identifier" > partn< / span > < span class = "plain" > , < / span > < span class = "identifier" > V< / span > < span class = "plain" > -> < / span > < span class = "element" > vol_title< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > HTML_CLOSE< / span > < span class = "plain" > (< / span > < span class = "string" > "p"< / span > < span class = "plain" > );< / span >
< span class = "identifier" > DISCARD_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > partn< / span > < span class = "plain" > );< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "endnote" > This code is used in < a href = "#SP2" > § 2< / a > .< / p >
< p class = "inwebparagraph" > < a id = "SP2_2" > < / a > < b > § 2.2. < / b > Some cumbersome Perl to produce a balanced two-column chapter listing:
< / p >
< p class = "macrodefinition" > < code class = "display" >
< < span class = "cwebmacrodefn" > Render a chapter-contents table< / span > < span class = "cwebmacronumber" > 2.2< / span > > =
< / code > < / p >
< pre class = "displaydefn" >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > HTML_OPEN_WITH< / span > < span class = "plain" > (< / span > < span class = "string" > "table"< / span > < span class = "plain" > , < / span > < span class = "string" > "class=\"centredtable\""< / span > < span class = "plain" > );< / span >
< span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > nch< / span > < span class = "plain" > = < / span > < span class = "identifier" > V< / span > < span class = "plain" > -> < / span > < span class = "element" > vol_chapter_count< / span > < span class = "plain" > ;< / span >
2019-03-17 14:40:57 +02:00
< span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > rows< / span > < span class = "plain" > = < / span > < span class = "identifier" > nch< / span > < span class = "plain" > /2;< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (2 * < / span > < span class = "identifier" > rows< / span > < span class = "plain" > < < / span > < span class = "identifier" > nch< / span > < span class = "plain" > ) < / span > < span class = "identifier" > rows< / span > < span class = "plain" > ++;< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > for< / span > < span class = "plain" > (< / span > < span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > rc< / span > < span class = "plain" > = < / span > < span class = "constant" > 0< / span > < span class = "plain" > ; < / span > < span class = "identifier" > rc< / span > < span class = "plain" > < < / span > < span class = "identifier" > rows< / span > < span class = "plain" > ; < / span > < span class = "identifier" > rc< / span > < span class = "plain" > ++) {< / span >
< span class = "reserved" > chapter< / span > < span class = "plain" > *< / span > < span class = "identifier" > C< / span > < span class = "plain" > = < / span > < span class = "identifier" > V< / span > < span class = "plain" > -> < / span > < span class = "element" > chapters< / span > < span class = "plain" > [< / span > < span class = "identifier" > rc< / span > < span class = "plain" > ];< / span >
< span class = "reserved" > chapter< / span > < span class = "plain" > *< / span > < span class = "identifier" > OC< / span > < span class = "plain" > = < / span > < span class = "identifier" > V< / span > < span class = "plain" > -> < / span > < span class = "element" > chapters< / span > < span class = "plain" > [< / span > < span class = "identifier" > rc< / span > < span class = "plain" > + < / span > < span class = "identifier" > rows< / span > < span class = "plain" > ];< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > HTML_OPEN< / span > < span class = "plain" > (< / span > < span class = "string" > "tr"< / span > < span class = "plain" > );< / span >
< span class = "identifier" > HTML_OPEN< / span > < span class = "plain" > (< / span > < span class = "string" > "td"< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "5-htm.html#SP15" > HTML::begin_link_with_class< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "standardlink"< / span > < span class = "plain" > , < / span > < span class = "identifier" > C< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_URL< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > HTML_OPEN_WITH< / span > < span class = "plain" > (< / span > < span class = "string" > "span"< / span > < span class = "plain" > , < / span > < span class = "string" > "class=\"chapterlisting\""< / span > < span class = "plain" > );< / span >
< span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "%S"< / span > < span class = "plain" > , < / span > < span class = "identifier" > C< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_full_title< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > HTML_CLOSE< / span > < span class = "plain" > (< / span > < span class = "string" > "span"< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "5-htm.html#SP15" > HTML::end_link< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "& #160;& #160;& #160;< /td> "< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > OC< / span > < span class = "plain" > ) {< / span >
< span class = "identifier" > HTML_OPEN< / span > < span class = "plain" > (< / span > < span class = "string" > "td"< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "5-htm.html#SP15" > HTML::begin_link_with_class< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "standardlink"< / span > < span class = "plain" > , < / span > < span class = "identifier" > OC< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_URL< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > HTML_OPEN_WITH< / span > < span class = "plain" > (< / span > < span class = "string" > "span"< / span > < span class = "plain" > , < / span > < span class = "string" > "class=\"chapterlisting\""< / span > < span class = "plain" > );< / span >
< span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "%S"< / span > < span class = "plain" > , < / span > < span class = "identifier" > OC< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_full_title< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > HTML_CLOSE< / span > < span class = "plain" > (< / span > < span class = "string" > "span"< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "5-htm.html#SP15" > HTML::end_link< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "& #160;& #160;& #160;< /td> "< / span > < span class = "plain" > );< / span >
< span class = "plain" > }< / span >
< span class = "identifier" > HTML_CLOSE< / span > < span class = "plain" > (< / span > < span class = "string" > "tr"< / span > < span class = "plain" > );< / span >
< span class = "plain" > }< / span >
< span class = "identifier" > HTML_CLOSE< / span > < span class = "plain" > (< / span > < span class = "string" > "table"< / span > < span class = "plain" > );< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "endnote" > This code is used in < a href = "#SP2" > § 2< / a > .< / p >
< p class = "inwebparagraph" > < a id = "SP2_3" > < / a > < b > § 2.3. < / b > < code class = "display" >
< < span class = "cwebmacrodefn" > Render the volume-top roadsign< / span > < span class = "cwebmacronumber" > 2.3< / span > > =
< / code > < / p >
< pre class = "displaydefn" >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP9" > Roadsign::roadsign_begin< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "constant" > 1< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > TEMPORARY_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > txt< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > txt< / span > < span class = "plain" > , < / span > < span class = "string" > "Start reading here: %c%S"< / span > < span class = "plain" > , < / span > < span class = "constant" > SECTION_SYMBOL< / span > < span class = "plain" > , < / span > < span class = "identifier" > V< / span > < span class = "plain" > -> < / span > < span class = "element" > sections< / span > < span class = "plain" > [0]-> < / span > < span class = "element" > title< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-right.png"< / span > < span class = "plain" > , < / span > < span class = "identifier" > txt< / span > < span class = "plain" > , < / span > < span class = "identifier" > V< / span > < span class = "plain" > -> < / span > < span class = "element" > chapters< / span > < span class = "plain" > [0]-> < / span > < span class = "element" > chapter_URL< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > no_volumes< / span > < span class = "plain" > > < / span > < span class = "constant" > 1< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > for< / span > < span class = "plain" > (< / span > < span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > v< / span > < span class = "plain" > = < / span > < span class = "constant" > 0< / span > < span class = "plain" > ; < / span > < span class = "identifier" > v< / span > < span class = "plain" > < < / span > < span class = "identifier" > no_volumes< / span > < span class = "plain" > ; < / span > < span class = "identifier" > v< / span > < span class = "plain" > ++) {< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > TEMPORARY_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > icon< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > v< / span > < span class = "plain" > < < / span > < span class = "identifier" > V< / span > < span class = "plain" > -> < / span > < span class = "identifier" > allocation_id< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > icon< / span > < span class = "plain" > , < / span > < span class = "string" > "arrow-up"< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > v< / span > < span class = "plain" > > < / span > < span class = "identifier" > V< / span > < span class = "plain" > -> < / span > < span class = "identifier" > allocation_id< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > icon< / span > < span class = "plain" > , < / span > < span class = "string" > "arrow-down"< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "functiontext" > < a href = "4-sm.html#SP8" > Str::len< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > icon< / span > < span class = "plain" > ) > < / span > < span class = "constant" > 0< / span > < span class = "plain" > ) {< / span >
2019-03-17 14:40:57 +02:00
< span class = "reserved" > volume< / span > < span class = "plain" > *< / span > < span class = "identifier" > LV< / span > < span class = "plain" > = < / span > < span class = "identifier" > volumes< / span > < span class = "plain" > [< / span > < span class = "identifier" > v< / span > < span class = "plain" > ];< / span >
< span class = "identifier" > TEMPORARY_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > txt< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP12" > Roadsign::roman_numeral< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > txt< / span > < span class = "plain" > , < / span > < span class = "identifier" > v< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > txt< / span > < span class = "plain" > , < / span > < span class = "string" > "%S"< / span > < span class = "plain" > , < / span > < span class = "identifier" > LV< / span > < span class = "plain" > -> < / span > < span class = "element" > vol_title< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > TEMPORARY_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > img< / span > < span class = "plain" > );< / span >
< span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > img< / span > < span class = "plain" > , < / span > < span class = "string" > "%S.png"< / span > < span class = "plain" > , < / span > < span class = "identifier" > icon< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > img< / span > < span class = "plain" > , < / span > < span class = "identifier" > txt< / span > < span class = "plain" > , < / span > < span class = "identifier" > LV< / span > < span class = "plain" > -> < / span > < span class = "element" > vol_URL< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > DISCARD_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > txt< / span > < span class = "plain" > );< / span >
< span class = "identifier" > DISCARD_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > img< / span > < span class = "plain" > );< / span >
< span class = "plain" > }< / span >
< span class = "identifier" > DISCARD_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > icon< / span > < span class = "plain" > );< / span >
< span class = "plain" > }< / span >
< span class = "plain" > }< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > ((< / span > < span class = "identifier" > no_examples< / span > < span class = "plain" > > < / span > < span class = "constant" > 0< / span > < span class = "plain" > ) & & (< / span > < span class = "identifier" > NUMBER_CREATED< / span > < span class = "plain" > (< / span > < span class = "reserved" > index_lemma< / span > < span class = "plain" > ) > < / span > < span class = "constant" > 0< / span > < span class = "plain" > )) {< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-down-right.png"< / span > < span class = "plain" > ,< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > I< / span > < span class = "string" > "Indexes of the examples and definitions"< / span > < span class = "plain" > , < / span > < span class = "identifier" > indoc_settings< / span > < span class = "plain" > -> < / span > < span class = "element" > examples_alphabetical_leafname< / span > < span class = "plain" > );< / span >
< span class = "plain" > } < / span > < span class = "reserved" > else< / span > < span class = "plain" > < / span > < span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > no_examples< / span > < span class = "plain" > > < / span > < span class = "constant" > 0< / span > < span class = "plain" > ) {< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-down-right.png"< / span > < span class = "plain" > ,< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > I< / span > < span class = "string" > "Indexes of the examples"< / span > < span class = "plain" > , < / span > < span class = "identifier" > indoc_settings< / span > < span class = "plain" > -> < / span > < span class = "element" > examples_alphabetical_leafname< / span > < span class = "plain" > );< / span >
< span class = "plain" > } < / span > < span class = "reserved" > else< / span > < span class = "plain" > < / span > < span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > NUMBER_CREATED< / span > < span class = "plain" > (< / span > < span class = "reserved" > index_lemma< / span > < span class = "plain" > ) > < / span > < span class = "constant" > 0< / span > < span class = "plain" > ) {< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-down-right.png"< / span > < span class = "plain" > ,< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > I< / span > < span class = "string" > "Index of definitions"< / span > < span class = "plain" > , < / span > < span class = "identifier" > indoc_settings< / span > < span class = "plain" > -> < / span > < span class = "element" > definitions_index_leafname< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP11" > Roadsign::roadsign_end< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "constant" > 1< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "endnote" > This code is used in < a href = "#SP2" > § 2< / a > .< / p >
< p class = "inwebparagraph" > < a id = "SP3" > < / a > < b > § 3. < / b > < / p >
< pre class = "display" >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > void< / span > < span class = "plain" > < / span > < span class = "functiontext" > Roadsign::roadsign_chapter_title< button class = "popup" onclick = "togglePopup('usagePopup170')" > ...< span class = "popuptext" id = "usagePopup170" > Usage of < b > Roadsign::roadsign_chapter_title< / b > :< br > < a href = "#SP1" > § 1< / a > < / span > < / button > < / span > < span class = "plain" > (< / span > < span class = "reserved" > navigation_design< / span > < span class = "plain" > *< / span > < span class = "identifier" > self< / span > < span class = "plain" > , < / span > < span class = "reserved" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "reserved" > volume< / span > < span class = "plain" > *< / span > < span class = "identifier" > V< / span > < span class = "plain" > , < / span > < span class = "reserved" > chapter< / span > < span class = "plain" > *< / span > < span class = "identifier" > C< / span > < span class = "plain" > ) {< / span >
2019-03-17 14:40:57 +02:00
< < span class = "cwebmacro" > Render a chapter heading< / span > < span class = "cwebmacronumber" > 3.1< / span > > < span class = "plain" > ;< / span >
< < span class = "cwebmacro" > Render a section-contents listing< / span > < span class = "cwebmacronumber" > 3.2< / span > > < span class = "plain" > ;< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP8" > Roadsign::roadsign_chapter_jumps< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > V< / span > < span class = "plain" > , < / span > < span class = "identifier" > C< / span > < span class = "plain" > , < / span > < span class = "constant" > 0< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "inwebparagraph" > < a id = "SP3_1" > < / a > < b > § 3.1. < / b > < code class = "display" >
< < span class = "cwebmacrodefn" > Render a chapter heading< / span > < span class = "cwebmacronumber" > 3.1< / span > > =
< / code > < / p >
< pre class = "displaydefn" >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > HTML_OPEN_WITH< / span > < span class = "plain" > (< / span > < span class = "string" > "p"< / span > < span class = "plain" > , < / span > < span class = "string" > "class=\"chapterheading\""< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "functiontext" > < a href = "4-sm.html#SP8" > Str::len< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > C< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_anchor< / span > < span class = "plain" > ) > < / span > < span class = "constant" > 0< / span > < span class = "plain" > ) < / span > < span class = "functiontext" > < a href = "5-htm.html#SP15" > HTML::anchor< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > C< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_anchor< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "%S"< / span > < span class = "plain" > , < / span > < span class = "identifier" > C< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_full_title< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > HTML_CLOSE< / span > < span class = "plain" > (< / span > < span class = "string" > "p"< / span > < span class = "plain" > );< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "endnote" > This code is used in < a href = "#SP3" > § 3< / a > .< / p >
< p class = "inwebparagraph" > < a id = "SP3_2" > < / a > < b > § 3.2. < / b > < code class = "display" >
< < span class = "cwebmacrodefn" > Render a section-contents listing< / span > < span class = "cwebmacronumber" > 3.2< / span > > =
< / code > < / p >
< pre class = "displaydefn" >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > HTML_OPEN_WITH< / span > < span class = "plain" > (< / span > < span class = "string" > "p"< / span > < span class = "plain" > , < / span > < span class = "string" > "class=\"chaptercontents\""< / span > < span class = "plain" > );< / span >
< span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > lcount< / span > < span class = "plain" > = < / span > < span class = "constant" > 0< / span > < span class = "plain" > ;< / span >
< span class = "reserved" > for< / span > < span class = "plain" > (< / span > < span class = "reserved" > section< / span > < span class = "plain" > *< / span > < span class = "identifier" > S< / span > < span class = "plain" > = < / span > < span class = "identifier" > V< / span > < span class = "plain" > -> < / span > < span class = "element" > sections< / span > < span class = "plain" > [0]; < / span > < span class = "identifier" > S< / span > < span class = "plain" > ; < / span > < span class = "identifier" > S< / span > < span class = "plain" > = < / span > < span class = "identifier" > S< / span > < span class = "plain" > -> < / span > < span class = "element" > next_section< / span > < span class = "plain" > )< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > S< / span > < span class = "plain" > -> < / span > < span class = "element" > in_which_chapter< / span > < span class = "plain" > == < / span > < span class = "identifier" > C< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > lcount< / span > < span class = "plain" > ++ > < / span > < span class = "constant" > 0< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "; "< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "5-htm.html#SP15" > HTML::begin_link_with_class< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "standardlink"< / span > < span class = "plain" > , < / span > < span class = "identifier" > S< / span > < span class = "plain" > -> < / span > < span class = "element" > section_URL< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > HTML_OPEN_WITH< / span > < span class = "plain" > (< / span > < span class = "string" > "span"< / span > < span class = "plain" > , < / span > < span class = "string" > "class=\"chaptercontentsitem\""< / span > < span class = "plain" > );< / span >
< span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "%c%S"< / span > < span class = "plain" > , < / span > < span class = "constant" > SECTION_SYMBOL< / span > < span class = "plain" > , < / span > < span class = "identifier" > S< / span > < span class = "plain" > -> < / span > < span class = "identifier" > title< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > HTML_CLOSE< / span > < span class = "plain" > (< / span > < span class = "string" > "span"< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "5-htm.html#SP15" > HTML::end_link< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
< span class = "identifier" > HTML_CLOSE< / span > < span class = "plain" > (< / span > < span class = "string" > "p"< / span > < span class = "plain" > );< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "endnote" > This code is used in < a href = "#SP3" > § 3< / a > .< / p >
< p class = "inwebparagraph" > < a id = "SP4" > < / a > < b > § 4. < / b > < / p >
< pre class = "display" >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > void< / span > < span class = "plain" > < / span > < span class = "functiontext" > Roadsign::roadsign_section_title< button class = "popup" onclick = "togglePopup('usagePopup171')" > ...< span class = "popuptext" id = "usagePopup171" > Usage of < b > Roadsign::roadsign_section_title< / b > :< br > < a href = "#SP1" > § 1< / a > < / span > < / button > < / span > < span class = "plain" > (< / span > < span class = "reserved" > navigation_design< / span > < span class = "plain" > *< / span > < span class = "identifier" > self< / span > < span class = "plain" > , < / span > < span class = "reserved" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "reserved" > volume< / span > < span class = "plain" > *< / span > < span class = "identifier" > V< / span > < span class = "plain" > , < / span > < span class = "reserved" > chapter< / span > < span class = "plain" > *< / span > < span class = "identifier" > C< / span > < span class = "plain" > , < / span > < span class = "reserved" > section< / span > < span class = "plain" > *< / span > < span class = "identifier" > S< / span > < span class = "plain" > ) {< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > HTML_OPEN_WITH< / span > < span class = "plain" > (< / span > < span class = "string" > "p"< / span > < span class = "plain" > , < / span > < span class = "string" > "class=\"sectionheading\""< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "functiontext" > < a href = "4-sm.html#SP8" > Str::len< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > S< / span > < span class = "plain" > -> < / span > < span class = "element" > section_anchor< / span > < span class = "plain" > ) > < / span > < span class = "constant" > 0< / span > < span class = "plain" > ) < / span > < span class = "functiontext" > < a href = "5-htm.html#SP15" > HTML::anchor< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > S< / span > < span class = "plain" > -> < / span > < span class = "element" > section_anchor< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "%c%S"< / span > < span class = "plain" > , < / span > < span class = "constant" > SECTION_SYMBOL< / span > < span class = "plain" > , < / span > < span class = "identifier" > S< / span > < span class = "plain" > -> < / span > < span class = "identifier" > title< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > HTML_CLOSE< / span > < span class = "plain" > (< / span > < span class = "string" > "p"< / span > < span class = "plain" > );< / span >
< span class = "plain" > }< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "inwebparagraph" > < a id = "SP5" > < / a > < b > § 5. Index top. < / b > And this is a variant for index pages, such as the index of examples.
< / p >
< pre class = "display" >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > void< / span > < span class = "plain" > < / span > < span class = "functiontext" > Roadsign::roadsign_navigation_index_top< button class = "popup" onclick = "togglePopup('usagePopup172')" > ...< span class = "popuptext" id = "usagePopup172" > Usage of < b > Roadsign::roadsign_navigation_index_top< / b > :< br > < a href = "#SP1" > § 1< / a > < / span > < / button > < / span > < span class = "plain" > (< / span > < span class = "reserved" > navigation_design< / span > < span class = "plain" > *< / span > < span class = "identifier" > self< / span > < span class = "plain" > , < / span > < span class = "reserved" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "reserved" > text_stream< / span > < span class = "plain" > *< / span > < span class = "reserved" > filename< / span > < span class = "plain" > , < / span > < span class = "reserved" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > title< / span > < span class = "plain" > ) {< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > HTML_OPEN_WITH< / span > < span class = "plain" > (< / span > < span class = "string" > "p"< / span > < span class = "plain" > , < / span > < span class = "string" > "class=\"chapterheading\""< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "%S"< / span > < span class = "plain" > , < / span > < span class = "identifier" > title< / span > < span class = "plain" > );< / span >
< span class = "identifier" > HTML_CLOSE< / span > < span class = "plain" > (< / span > < span class = "string" > "p"< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP9" > Roadsign::roadsign_begin< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "constant" > 1< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > no_examples< / span > < span class = "plain" > > < / span > < span class = "constant" > 0< / span > < span class = "plain" > ) {< / span >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "functiontext" > < a href = "4-sm.html#SP18" > Str::ne< / a > < / span > < span class = "plain" > (< / span > < span class = "reserved" > filename< / span > < span class = "plain" > , < / span > < span class = "identifier" > indoc_settings< / span > < span class = "plain" > -> < / span > < span class = "element" > examples_alphabetical_leafname< / span > < span class = "plain" > ))< / span >
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-right.png"< / span > < span class = "plain" > ,< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > I< / span > < span class = "string" > "Examples in Alphabetical Order"< / span > < span class = "plain" > , < / span > < span class = "identifier" > indoc_settings< / span > < span class = "plain" > -> < / span > < span class = "element" > examples_alphabetical_leafname< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "functiontext" > < a href = "4-sm.html#SP18" > Str::ne< / a > < / span > < span class = "plain" > (< / span > < span class = "reserved" > filename< / span > < span class = "plain" > , < / span > < span class = "identifier" > indoc_settings< / span > < span class = "plain" > -> < / span > < span class = "element" > examples_thematic_leafname< / span > < span class = "plain" > ))< / span >
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-right.png"< / span > < span class = "plain" > ,< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > I< / span > < span class = "string" > "Examples in Thematic Order"< / span > < span class = "plain" > , < / span > < span class = "identifier" > indoc_settings< / span > < span class = "plain" > -> < / span > < span class = "element" > examples_thematic_leafname< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "functiontext" > < a href = "4-sm.html#SP18" > Str::ne< / a > < / span > < span class = "plain" > (< / span > < span class = "reserved" > filename< / span > < span class = "plain" > , < / span > < span class = "identifier" > indoc_settings< / span > < span class = "plain" > -> < / span > < span class = "element" > examples_numerical_leafname< / span > < span class = "plain" > ))< / span >
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-right.png"< / span > < span class = "plain" > ,< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > I< / span > < span class = "string" > "Examples in Numerical Order"< / span > < span class = "plain" > , < / span > < span class = "identifier" > indoc_settings< / span > < span class = "plain" > -> < / span > < span class = "element" > examples_numerical_leafname< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > NUMBER_CREATED< / span > < span class = "plain" > (< / span > < span class = "reserved" > index_lemma< / span > < span class = "plain" > ) > < / span > < span class = "constant" > 0< / span > < span class = "plain" > )< / span >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "functiontext" > < a href = "4-sm.html#SP18" > Str::ne< / a > < / span > < span class = "plain" > (< / span > < span class = "reserved" > filename< / span > < span class = "plain" > , < / span > < span class = "identifier" > indoc_settings< / span > < span class = "plain" > -> < / span > < span class = "element" > definitions_index_leafname< / span > < span class = "plain" > ))< / span >
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-right.png"< / span > < span class = "plain" > ,< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > I< / span > < span class = "string" > "General Index"< / span > < span class = "plain" > , < / span > < span class = "identifier" > indoc_settings< / span > < span class = "plain" > -> < / span > < span class = "element" > definitions_index_leafname< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
2020-04-07 03:06:09 +03:00
< span class = "reserved" > for< / span > < span class = "plain" > (< / span > < span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > v< / span > < span class = "plain" > = < / span > < span class = "constant" > 0< / span > < span class = "plain" > ; < / span > < span class = "identifier" > v< / span > < span class = "plain" > < < / span > < span class = "identifier" > no_volumes< / span > < span class = "plain" > ; < / span > < span class = "identifier" > v< / span > < span class = "plain" > ++) {< / span >
2019-03-17 14:40:57 +02:00
< span class = "reserved" > volume< / span > < span class = "plain" > *< / span > < span class = "identifier" > V< / span > < span class = "plain" > = < / span > < span class = "identifier" > volumes< / span > < span class = "plain" > [< / span > < span class = "identifier" > v< / span > < span class = "plain" > ];< / span >
< span class = "identifier" > TEMPORARY_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > text< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP12" > Roadsign::roman_numeral< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > text< / span > < span class = "plain" > , < / span > < span class = "identifier" > v< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > text< / span > < span class = "plain" > , < / span > < span class = "string" > "%S"< / span > < span class = "plain" > , < / span > < span class = "identifier" > V< / span > < span class = "plain" > -> < / span > < span class = "element" > vol_title< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > no_volumes< / span > < span class = "plain" > == < / span > < span class = "constant" > 1< / span > < span class = "plain" > ) < / span > < span class = "functiontext" > < a href = "4-sm.html#SP16" > Str::copy< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > text< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "Contents"< / span > < span class = "plain" > );< / span >
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-up-left.png"< / span > < span class = "plain" > , < / span > < span class = "identifier" > text< / span > < span class = "plain" > , < / span > < span class = "identifier" > V< / span > < span class = "plain" > -> < / span > < span class = "element" > vol_URL< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > DISCARD_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > text< / span > < span class = "plain" > );< / span >
< span class = "plain" > }< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP11" > Roadsign::roadsign_end< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "constant" > 1< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "2-haj.html#SP12" > HTMLUtilities::ruled_line< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "inwebparagraph" > < a id = "SP6" > < / a > < b > § 6. Middle. < / b > At the middle part, when the text is over, but before any example cues.
< / p >
< pre class = "display" >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > void< / span > < span class = "plain" > < / span > < span class = "functiontext" > Roadsign::roadsign_navigation_middle< button class = "popup" onclick = "togglePopup('usagePopup173')" > ...< span class = "popuptext" id = "usagePopup173" > Usage of < b > Roadsign::roadsign_navigation_middle< / b > :< br > < a href = "#SP1" > § 1< / a > < / span > < / button > < / span > < span class = "plain" > (< / span > < span class = "reserved" > navigation_design< / span > < span class = "plain" > *< / span > < span class = "identifier" > self< / span > < span class = "plain" > , < / span > < span class = "reserved" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "reserved" > volume< / span > < span class = "plain" > *< / span > < span class = "identifier" > V< / span > < span class = "plain" > , < / span > < span class = "reserved" > section< / span > < span class = "plain" > *< / span > < span class = "identifier" > S< / span > < span class = "plain" > ) {< / span >
< span class = "functiontext" > < a href = "2-haj.html#SP12" > HTMLUtilities::ruled_line< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > );< / span >
< span class = "functiontext" > < a href = "5-htm.html#SP13" > HTML::begin_div_with_class_S< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "roadsigns"< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > chapter< / span > < span class = "plain" > *< / span > < span class = "identifier" > C< / span > < span class = "plain" > = < / span > < span class = "identifier" > S< / span > < span class = "plain" > -> < / span > < span class = "element" > in_which_chapter< / span > < span class = "plain" > ;< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP9" > Roadsign::roadsign_begin< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "constant" > 0< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< < span class = "cwebmacro" > Add home, back and forward directions to the roadsign< / span > < span class = "cwebmacronumber" > 6.1< / span > > < span class = "plain" > ;< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > indoc_settings< / span > < span class = "plain" > -> < / span > < span class = "element" > examples_mode< / span > < span class = "plain" > == < / span > < span class = "constant" > EXMODE_open_internal< / span > < span class = "plain" > )< / span >
2019-03-17 14:40:57 +02:00
< < span class = "cwebmacro" > Add directions to this section's examples to the roadsign< / span > < span class = "cwebmacronumber" > 6.2< / span > > < span class = "character" > ;< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP11" > Roadsign::roadsign_end< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "constant" > 0< / span > < span class = "plain" > );< / span >
< span class = "functiontext" > < a href = "2-haj.html#SP12" > HTMLUtilities::ruled_line< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > );< / span >
< span class = "functiontext" > < a href = "5-htm.html#SP13" > HTML::end_div< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "inwebparagraph" > < a id = "SP6_1" > < / a > < b > § 6.1. < / b > < code class = "display" >
< < span class = "cwebmacrodefn" > Add home, back and forward directions to the roadsign< / span > < span class = "cwebmacronumber" > 6.1< / span > > =
< / code > < / p >
< pre class = "displaydefn" >
< span class = "identifier" > TEMPORARY_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > txt< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > txt< / span > < span class = "plain" > , < / span > < span class = "string" > "Start of %S"< / span > < span class = "plain" > , < / span > < span class = "identifier" > C< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_full_title< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-up.png"< / span > < span class = "plain" > , < / span > < span class = "identifier" > txt< / span > < span class = "plain" > , < / span > < span class = "identifier" > C< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_URL< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > DISCARD_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > txt< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > S< / span > < span class = "plain" > -> < / span > < span class = "element" > previous_section< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > chapter< / span > < span class = "plain" > *< / span > < span class = "identifier" > to_chap< / span > < span class = "plain" > = < / span > < span class = "identifier" > S< / span > < span class = "plain" > -> < / span > < span class = "element" > previous_section< / span > < span class = "plain" > -> < / span > < span class = "element" > in_which_chapter< / span > < span class = "plain" > ;< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > TEMPORARY_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > link< / span > < span class = "plain" > );< / span >
< span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > link< / span > < span class = "plain" > , < / span > < span class = "string" > "Back to "< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > to_chap< / span > < span class = "plain" > != < / span > < span class = "identifier" > C< / span > < span class = "plain" > )< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > link< / span > < span class = "plain" > , < / span > < span class = "string" > "Chapter %d: %S: "< / span > < span class = "plain" > , < / span > < span class = "identifier" > to_chap< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_number< / span > < span class = "plain" > , < / span > < span class = "identifier" > to_chap< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_title< / span > < span class = "plain" > );< / span >
< span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > link< / span > < span class = "plain" > , < / span > < span class = "string" > "%c%S"< / span > < span class = "plain" > , < / span > < span class = "constant" > SECTION_SYMBOL< / span > < span class = "plain" > , < / span > < span class = "identifier" > S< / span > < span class = "plain" > -> < / span > < span class = "element" > previous_section< / span > < span class = "plain" > -> < / span > < span class = "element" > title< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-left.png"< / span > < span class = "plain" > ,< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > link< / span > < span class = "plain" > , < / span > < span class = "identifier" > S< / span > < span class = "plain" > -> < / span > < span class = "element" > previous_section< / span > < span class = "plain" > -> < / span > < span class = "element" > section_URL< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > DISCARD_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > link< / span > < span class = "plain" > );< / span >
< span class = "plain" > }< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > S< / span > < span class = "plain" > -> < / span > < span class = "element" > next_section< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > chapter< / span > < span class = "plain" > *< / span > < span class = "identifier" > to_chap< / span > < span class = "plain" > = < / span > < span class = "identifier" > S< / span > < span class = "plain" > -> < / span > < span class = "element" > next_section< / span > < span class = "plain" > -> < / span > < span class = "element" > in_which_chapter< / span > < span class = "plain" > ;< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > TEMPORARY_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > link< / span > < span class = "plain" > );< / span >
< span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > link< / span > < span class = "plain" > , < / span > < span class = "string" > "Onward to "< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > to_chap< / span > < span class = "plain" > != < / span > < span class = "identifier" > C< / span > < span class = "plain" > )< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > link< / span > < span class = "plain" > , < / span > < span class = "string" > "Chapter %d: %S: "< / span > < span class = "plain" > , < / span > < span class = "identifier" > to_chap< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_number< / span > < span class = "plain" > , < / span > < span class = "identifier" > to_chap< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_title< / span > < span class = "plain" > );< / span >
< span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > link< / span > < span class = "plain" > , < / span > < span class = "string" > "%c%S"< / span > < span class = "plain" > , < / span > < span class = "constant" > SECTION_SYMBOL< / span > < span class = "plain" > , < / span > < span class = "identifier" > S< / span > < span class = "plain" > -> < / span > < span class = "element" > next_section< / span > < span class = "plain" > -> < / span > < span class = "element" > title< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-right.png"< / span > < span class = "plain" > ,< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > link< / span > < span class = "plain" > , < / span > < span class = "identifier" > S< / span > < span class = "plain" > -> < / span > < span class = "element" > next_section< / span > < span class = "plain" > -> < / span > < span class = "element" > section_URL< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > DISCARD_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > link< / span > < span class = "plain" > );< / span >
< span class = "plain" > }< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "endnote" > This code is used in < a href = "#SP6" > § 6< / a > .< / p >
< p class = "inwebparagraph" > < a id = "SP6_2" > < / a > < b > § 6.2. < / b > < code class = "display" >
< < span class = "cwebmacrodefn" > Add directions to this section's examples to the roadsign< / span > < span class = "cwebmacronumber" > 6.2< / span > > =
< / code > < / p >
< pre class = "displaydefn" >
< span class = "reserved" > example< / span > < span class = "plain" > *< / span > < span class = "identifier" > E< / span > < span class = "plain" > ;< / span >
< span class = "identifier" > LOOP_OVER< / span > < span class = "plain" > (< / span > < span class = "identifier" > E< / span > < span class = "plain" > , < / span > < span class = "reserved" > example< / span > < span class = "plain" > ) {< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > E< / span > < span class = "plain" > -> < / span > < span class = "element" > example_belongs_to_section< / span > < span class = "plain" > [< / span > < span class = "identifier" > V< / span > < span class = "plain" > -> < / span > < span class = "element" > allocation_id< / span > < span class = "plain" > ] == < / span > < span class = "identifier" > S< / span > < span class = "plain" > ) {< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > TEMPORARY_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > stars< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > for< / span > < span class = "plain" > (< / span > < span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > starcc< / span > < span class = "plain" > =0; < / span > < span class = "identifier" > starcc< / span > < span class = "plain" > < < / span > < span class = "identifier" > E< / span > < span class = "plain" > -> < / span > < span class = "element" > ex_star_count< / span > < span class = "plain" > ; < / span > < span class = "identifier" > starcc< / span > < span class = "plain" > ++)< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "2-haj.html#SP13" > HTMLUtilities::asterisk_image< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > stars< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "asterisk.png"< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > TEMPORARY_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > pn< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "4-sm.html#SP16" > Str::copy< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > pn< / span > < span class = "plain" > , < / span > < span class = "identifier" > E< / span > < span class = "plain" > -> < / span > < span class = "element" > ex_public_name< / span > < span class = "plain" > );< / span >
< span class = "functiontext" > < a href = "2-rr.html#SP5" > Rawtext::escape_HTML_characters_in< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > pn< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > TEMPORARY_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > text< / span > < span class = "plain" > );< / span >
< span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > text< / span > < span class = "plain" > , < / span > < span class = "string" > "Example %d: %S < b> %S< /b> & #160;& #160;& #160; %S"< / span > < span class = "plain" > ,< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > E< / span > < span class = "plain" > -> < / span > < span class = "element" > example_position< / span > < span class = "plain" > [0], < / span > < span class = "identifier" > stars< / span > < span class = "plain" > , < / span > < span class = "identifier" > pn< / span > < span class = "plain" > , < / span > < span class = "identifier" > E< / span > < span class = "plain" > -> < / span > < span class = "element" > ex_outline< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > TEMPORARY_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > url< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "2-exm.html#SP11" > Examples::goto_example_url< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > url< / span > < span class = "plain" > , < / span > < span class = "identifier" > E< / span > < span class = "plain" > , < / span > < span class = "identifier" > V< / span > < span class = "plain" > );< / span >
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-down.png"< / span > < span class = "plain" > , < / span > < span class = "identifier" > text< / span > < span class = "plain" > , < / span > < span class = "identifier" > url< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > DISCARD_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > text< / span > < span class = "plain" > );< / span >
< span class = "identifier" > DISCARD_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > stars< / span > < span class = "plain" > );< / span >
< span class = "identifier" > DISCARD_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > url< / span > < span class = "plain" > );< / span >
< span class = "plain" > }< / span >
< span class = "plain" > }< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "endnote" > This code is used in < a href = "#SP6" > § 6< / a > .< / p >
< p class = "inwebparagraph" > < a id = "SP7" > < / a > < b > § 7. Example top. < / b > This is reached before the first example is rendered, provided at least
one example will be:
< / p >
< pre class = "display" >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > void< / span > < span class = "plain" > < / span > < span class = "functiontext" > Roadsign::roadsign_navigation_example_top< button class = "popup" onclick = "togglePopup('usagePopup174')" > ...< span class = "popuptext" id = "usagePopup174" > Usage of < b > Roadsign::roadsign_navigation_example_top< / b > :< br > < a href = "#SP1" > § 1< / a > < / span > < / button > < / span > < span class = "plain" > (< / span > < span class = "reserved" > navigation_design< / span > < span class = "plain" > *< / span > < span class = "identifier" > self< / span > < span class = "plain" > , < / span > < span class = "reserved" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "reserved" > volume< / span > < span class = "plain" > *< / span > < span class = "identifier" > V< / span > < span class = "plain" > , < / span > < span class = "reserved" > section< / span > < span class = "plain" > *< / span > < span class = "identifier" > S< / span > < span class = "plain" > ) {< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > indoc_settings< / span > < span class = "plain" > -> < / span > < span class = "element" > examples_granularity< / span > < span class = "plain" > == < / span > < span class = "constant" > CHAPTER_GRANULARITY< / span > < span class = "plain" > )< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP8" > Roadsign::roadsign_chapter_jumps< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > V< / span > < span class = "plain" > , < / span > < span class = "identifier" > S< / span > < span class = "plain" > -> < / span > < span class = "element" > in_which_chapter< / span > < span class = "plain" > , < / span > < span class = "constant" > TRUE< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "inwebparagraph" > < a id = "SP8" > < / a > < b > § 8. Utility routines. < / b > < / p >
< pre class = "display" >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > void< / span > < span class = "plain" > < / span > < span class = "functiontext" > Roadsign::roadsign_chapter_jumps< button class = "popup" onclick = "togglePopup('usagePopup175')" > ...< span class = "popuptext" id = "usagePopup175" > Usage of < b > Roadsign::roadsign_chapter_jumps< / b > :< br > < a href = "#SP3" > § 3< / a > , < a href = "#SP7" > § 7< / a > < / span > < / button > < / span > < span class = "plain" > (< / span > < span class = "constant" > OUTPUT_STREAM< / span > < span class = "plain" > , < / span > < span class = "reserved" > volume< / span > < span class = "plain" > *< / span > < span class = "identifier" > V< / span > < span class = "plain" > , < / span > < span class = "reserved" > chapter< / span > < span class = "plain" > *< / span > < span class = "identifier" > C< / span > < span class = "plain" > , < / span > < span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > bottom< / span > < span class = "plain" > ) {< / span >
< span class = "functiontext" > < a href = "#SP9" > Roadsign::roadsign_begin< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "constant" > 1< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > chc< / span > < span class = "plain" > = < / span > < span class = "identifier" > V< / span > < span class = "plain" > -> < / span > < span class = "element" > vol_chapter_count< / span > < span class = "plain" > ;< / span >
< span class = "reserved" > if< / span > < span class = "plain" > ((< / span > < span class = "identifier" > chc< / span > < span class = "plain" > > < / span > < span class = "constant" > 1< / span > < span class = "plain" > ) & & (< / span > < span class = "identifier" > bottom< / span > < span class = "plain" > == < / span > < span class = "constant" > FALSE< / span > < span class = "plain" > )) {< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > TEMPORARY_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > text< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > text< / span > < span class = "plain" > , < / span > < span class = "string" > "Contents of < i> %S< /i> "< / span > < span class = "plain" > , < / span > < span class = "identifier" > V< / span > < span class = "plain" > -> < / span > < span class = "element" > vol_title< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-up-left.png"< / span > < span class = "plain" > , < / span > < span class = "identifier" > text< / span > < span class = "plain" > , < / span > < span class = "identifier" > V< / span > < span class = "plain" > -> < / span > < span class = "element" > vol_URL< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > DISCARD_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > text< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > C< / span > < span class = "plain" > -> < / span > < span class = "element" > previous_chapter< / span > < span class = "plain" > )< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-left.png"< / span > < span class = "plain" > ,< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > C< / span > < span class = "plain" > -> < / span > < span class = "element" > previous_chapter< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_full_title< / span > < span class = "plain" > , < / span > < span class = "identifier" > C< / span > < span class = "plain" > -> < / span > < span class = "element" > previous_chapter< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_URL< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > bottom< / span > < span class = "plain" > == < / span > < span class = "constant" > 1< / span > < span class = "plain" > )< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-up.png"< / span > < span class = "plain" > ,< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > I< / span > < span class = "string" > "Start of this chapter"< / span > < span class = "plain" > , < / span > < span class = "identifier" > C< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_URL< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > C< / span > < span class = "plain" > -> < / span > < span class = "element" > next_chapter< / span > < span class = "plain" > )< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-right.png"< / span > < span class = "plain" > ,< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > C< / span > < span class = "plain" > -> < / span > < span class = "element" > next_chapter< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_full_title< / span > < span class = "plain" > , < / span > < span class = "identifier" > C< / span > < span class = "plain" > -> < / span > < span class = "element" > next_chapter< / span > < span class = "plain" > -> < / span > < span class = "element" > chapter_URL< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > no_examples< / span > < span class = "plain" > > < / span > < span class = "constant" > 0< / span > < span class = "plain" > )< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP10" > Roadsign::roadsign_add_direction< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "arrow-down-right.png"< / span > < span class = "plain" > ,< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > I< / span > < span class = "string" > "Indexes of the examples"< / span > < span class = "plain" > ,< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > indoc_settings< / span > < span class = "plain" > -> < / span > < span class = "element" > examples_alphabetical_leafname< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "#SP11" > Roadsign::roadsign_end< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "constant" > 1< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "inwebparagraph" > < a id = "SP9" > < / a > < b > § 9. < / b > And at a lower level: here's how a roadsign is made, as a table of links.
< / p >
< pre class = "display" >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > void< / span > < span class = "plain" > < / span > < span class = "functiontext" > Roadsign::roadsign_begin< button class = "popup" onclick = "togglePopup('usagePopup176')" > ...< span class = "popuptext" id = "usagePopup176" > Usage of < b > Roadsign::roadsign_begin< / b > :< br > < a href = "#SP2_3" > § 2.3< / a > , < a href = "#SP5" > § 5< / a > , < a href = "#SP6" > § 6< / a > , < a href = "#SP8" > § 8< / a > < / span > < / button > < / span > < span class = "plain" > (< / span > < span class = "constant" > OUTPUT_STREAM< / span > < span class = "plain" > , < / span > < span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > centred< / span > < span class = "plain" > ) {< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > centred< / span > < span class = "plain" > ) < / span > < span class = "identifier" > HTML_OPEN_WITH< / span > < span class = "plain" > (< / span > < span class = "string" > "table"< / span > < span class = "plain" > , < / span > < span class = "string" > "class=\"centredtable\""< / span > < span class = "plain" > )< / span >
2019-03-17 14:40:57 +02:00
< span class = "reserved" > else< / span > < span class = "plain" > < / span > < span class = "identifier" > HTML_OPEN< / span > < span class = "plain" > (< / span > < span class = "string" > "table"< / span > < span class = "plain" > );< / span >
< span class = "plain" > }< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "inwebparagraph" > < a id = "SP10" > < / a > < b > § 10. < / b > This is a 2-column table: the link image in column 1, the text in column 2.
< / p >
< pre class = "display" >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > void< / span > < span class = "plain" > < / span > < span class = "functiontext" > Roadsign::roadsign_add_direction< button class = "popup" onclick = "togglePopup('usagePopup177')" > ...< span class = "popuptext" id = "usagePopup177" > Usage of < b > Roadsign::roadsign_add_direction< / b > :< br > < a href = "#SP2_3" > § 2.3< / a > , < a href = "#SP5" > § 5< / a > , < a href = "#SP6_1" > § 6.1< / a > , < a href = "#SP6_2" > § 6.2< / a > , < a href = "#SP8" > § 8< / a > < / span > < / button > < / span > < span class = "plain" > (< / span > < span class = "constant" > OUTPUT_STREAM< / span > < span class = "plain" > , < / span > < span class = "reserved" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > icon< / span > < span class = "plain" > , < / span > < span class = "reserved" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > text< / span > < span class = "plain" > , < / span > < span class = "reserved" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > url< / span > < span class = "plain" > ) {< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > HTML_OPEN< / span > < span class = "plain" > (< / span > < span class = "string" > "tr"< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > HTML_OPEN_WITH< / span > < span class = "plain" > (< / span > < span class = "string" > "td"< / span > < span class = "plain" > , < / span > < span class = "string" > "class=\"roadsigndirection\""< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "5-htm.html#SP15" > HTML::begin_link_with_class< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "standardlink"< / span > < span class = "plain" > , < / span > < span class = "identifier" > url< / span > < span class = "plain" > );< / span >
< span class = "functiontext" > < a href = "2-haj.html#SP13" > HTMLUtilities::image_element< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > icon< / span > < span class = "plain" > );< / span >
< span class = "functiontext" > < a href = "5-htm.html#SP15" > HTML::end_link< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > HTML_CLOSE< / span > < span class = "plain" > (< / span > < span class = "string" > "td"< / span > < span class = "plain" > );< / span >
< span class = "identifier" > HTML_OPEN< / span > < span class = "plain" > (< / span > < span class = "string" > "td"< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "5-htm.html#SP15" > HTML::begin_link_with_class< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > I< / span > < span class = "string" > "standardlink"< / span > < span class = "plain" > , < / span > < span class = "identifier" > url< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "%S"< / span > < span class = "plain" > , < / span > < span class = "identifier" > text< / span > < span class = "plain" > );< / span >
2020-04-14 19:56:54 +03:00
< span class = "functiontext" > < a href = "5-htm.html#SP15" > HTML::end_link< / a > < / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > HTML_CLOSE< / span > < span class = "plain" > (< / span > < span class = "string" > "td"< / span > < span class = "plain" > );< / span >
< span class = "identifier" > HTML_CLOSE< / span > < span class = "plain" > (< / span > < span class = "string" > "tr"< / span > < span class = "plain" > );< / span >
< span class = "plain" > }< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "inwebparagraph" > < a id = "SP11" > < / a > < b > § 11. < / b > < / p >
< pre class = "display" >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > void< / span > < span class = "plain" > < / span > < span class = "functiontext" > Roadsign::roadsign_end< button class = "popup" onclick = "togglePopup('usagePopup178')" > ...< span class = "popuptext" id = "usagePopup178" > Usage of < b > Roadsign::roadsign_end< / b > :< br > < a href = "#SP2_3" > § 2.3< / a > , < a href = "#SP5" > § 5< / a > , < a href = "#SP6" > § 6< / a > , < a href = "#SP8" > § 8< / a > < / span > < / button > < / span > < span class = "plain" > (< / span > < span class = "constant" > OUTPUT_STREAM< / span > < span class = "plain" > , < / span > < span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > cent< / span > < span class = "plain" > ) {< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > HTML_CLOSE< / span > < span class = "plain" > (< / span > < span class = "string" > "table"< / span > < span class = "plain" > );< / span >
< span class = "plain" > }< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "inwebparagraph" > < a id = "SP12" > < / a > < b > § 12. Ecce romani. < / b > < / p >
< pre class = "display" >
2020-04-14 19:56:54 +03:00
< span class = "reserved" > void< / span > < span class = "plain" > < / span > < span class = "functiontext" > Roadsign::roman_numeral< button class = "popup" onclick = "togglePopup('usagePopup179')" > ...< span class = "popuptext" id = "usagePopup179" > Usage of < b > Roadsign::roman_numeral< / b > :< br > < a href = "#SP2_1" > § 2.1< / a > , < a href = "#SP2_3" > § 2.3< / a > , < a href = "#SP5" > § 5< / a > , Codename Unsigned - < a href = "4-cu.html#SP2_1" > § 2.1< / a > < / span > < / button > < / span > < span class = "plain" > (< / span > < span class = "constant" > OUTPUT_STREAM< / span > < span class = "plain" > , < / span > < span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > v< / span > < span class = "plain" > ) {< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > v< / span > < span class = "plain" > == < / span > < span class = "constant" > 0< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "Part I. "< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > v< / span > < span class = "plain" > == < / span > < span class = "constant" > 1< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "Part II. "< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > v< / span > < span class = "plain" > == < / span > < span class = "constant" > 2< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "Part III. "< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > v< / span > < span class = "plain" > == < / span > < span class = "constant" > 3< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "Part IV. "< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > v< / span > < span class = "plain" > == < / span > < span class = "constant" > 4< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "Part V. "< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > v< / span > < span class = "plain" > == < / span > < span class = "constant" > 5< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "Part VI. "< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > v< / span > < span class = "plain" > == < / span > < span class = "constant" > 6< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "Part VII. "< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > v< / span > < span class = "plain" > == < / span > < span class = "constant" > 7< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "Part VIII. "< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > v< / span > < span class = "plain" > == < / span > < span class = "constant" > 8< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "Part IX. "< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > v< / span > < span class = "plain" > == < / span > < span class = "constant" > 9< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "Part X. "< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< hr class = "tocbar" >
< ul class = "toc" > < li > < a href = "4-ct.html" > Back to 'Codename Twilight'< / a > < / li > < li > < a href = "4-cu.html" > Continue with 'Codename Unsigned'< / a > < / li > < / ul > < hr class = "tocbar" >
2019-04-22 17:42:10 +03:00
<!-- End of weave -->
2020-04-14 19:56:54 +03:00
< script >
function togglePopup(material_id) {
var popup = document.getElementById(material_id);
popup.classList.toggle("show");
}
< / script >
< link href = "Popups.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
2020-03-19 02:11:25 +02:00
< / main >
2019-03-17 14:40:57 +02:00
< / body >
< / html >