2019-02-04 22:26:45 +00:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
< html >
< head >
2020-04-08 22:41:00 +00:00
< title > Bibliographic Data for Webs< / title >
2020-04-20 22:26:08 +00:00
< link href = "../docs-assets/Breadcrumbs.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
2020-03-19 00:03:04 +00:00
< meta name = "viewport" content = "width=device-width initial-scale=1" >
2019-02-04 22:26:45 +00:00
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" >
< meta http-equiv = "Content-Language" content = "en-gb" >
2020-04-20 22:26:08 +00:00
< link href = "../docs-assets/Base.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "../docs-assets/Colours.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< meta name = "viewport" content = "width=device-width initial-scale=1" >
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" >
< meta http-equiv = "Content-Language" content = "en-gb" >
< link href = "../docs-assets/Base.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "../docs-assets/Colours.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "../docs-assets/Breadcrumbs.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< script >
function togglePopup(material_id) {
var popup = document.getElementById(material_id);
popup.classList.toggle("show");
}
< / script >
< link href = "../docs-assets/Popups.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
2019-02-04 22:26:45 +00:00
< / head >
< body >
2020-03-19 00:03:04 +00:00
< nav role = "navigation" >
2020-04-13 16:06:45 +00:00
< h1 > < a href = "../index.html" >
2020-04-20 22:26:08 +00:00
< img src = "../docs-assets/Octagram.png" width = 72 height = 72" >
2020-04-13 16:06:45 +00:00
< / a > < / h1 >
< ul > < li > < a href = "../inweb/index.html" > inweb< / a > < / li >
< / ul > < h2 > Foundation Module< / h2 > < ul >
< li > < a href = "index.html" > < span class = "selectedlink" > foundation< / span > < / a > < / li >
2020-03-19 00:03:04 +00:00
< li > < a href = "../foundation-test/index.html" > foundation-test< / a > < / li >
2020-04-13 16:06:45 +00:00
< / ul > < h2 > Example Webs< / h2 > < ul >
2020-04-12 16:24:23 +00:00
< li > < a href = "../goldbach/index.html" > goldbach< / a > < / li >
< li > < a href = "../twinprimes/twinprimes.html" > twinprimes< / a > < / li >
2020-04-15 22:45:08 +00:00
< li > < a href = "../eastertide/index.html" > eastertide< / a > < / li >
2020-04-14 17:36:42 +00:00
< / ul > < h2 > Repository< / h2 > < ul >
2020-04-14 19:29:03 +00:00
< li > < a href = "https://github.com/ganelson/inweb" > < img src = "../github.png" height = 18 > github< / a > < / li >
2020-04-14 17:36:42 +00:00
< / ul > < h2 > Related Projects< / h2 > < ul >
< li > < a href = "../../../inform/docs/index.html" > inform< / a > < / li >
< li > < a href = "../../../intest/docs/index.html" > intest< / a > < / li >
2020-03-19 00:03:04 +00:00
2020-04-13 16:06:45 +00:00
< / ul >
2020-03-19 00:03:04 +00:00
< / nav >
< main role = "main" >
2020-04-16 22:51:03 +00:00
<!-- Weave of 'Bibliographic Data for Webs' generated by Inweb -->
2020-04-13 16:06:45 +00:00
< ul class = "crumbs" > < li > < a href = "../index.html" > Home< / a > < / li > < li > < a href = "index.html" > foundation< / a > < / li > < li > < a href = "index.html#8" > Chapter 8: Literate Programming< / a > < / li > < li > < b > Bibliographic Data for Webs< / b > < / li > < / ul > < p class = "purpose" > To manage key-value pairs of bibliographic data, metadata if you like, associated with a given web.< / p >
2019-02-04 22:26:45 +00:00
2020-04-15 22:45:08 +00:00
< ul class = "toc" > < li > < a href = "8-bdfw.html#SP1" > § 1. Storing data< / a > < / li > < li > < a href = "8-bdfw.html#SP4" > § 4. Initialising a web< / a > < / li > < li > < a href = "8-bdfw.html#SP6" > § 6. Reading bibliographic data< / a > < / li > < li > < a href = "8-bdfw.html#SP7" > § 7. Writing bibliographic data< / a > < / li > < / ul > < hr class = "tocbar" >
2019-02-04 22:26:45 +00:00
< p class = "inwebparagraph" > < a id = "SP1" > < / a > < b > § 1. Storing data. < / b > There are never more than a dozen or so key-value pairs, and it's more
convenient to store them directly here than to use a dictionary.
< / p >
< pre class = "display" >
2020-04-20 22:26:08 +00:00
< span class = "reserved-syntax" > typedef< / span > < span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > web_bibliographic_datum< / span > < span class = "plain-syntax" > {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > key< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > value< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > declaration_permitted< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment" > is the contents page of the web allowed to set this?< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > declaration_mandatory< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment" > is it positively required to?< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > on_or_off< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment" > boolean: which we handle as the string "On" or "Off"< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > web_bibliographic_datum< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > alias< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "constant-syntax" > MEMORY_MANAGEMENT< / span >
< span class = "plain-syntax" > } < / span > < span class = "reserved-syntax" > web_bibliographic_datum< / span > < span class = "plain-syntax" > ;< / span >
2019-02-04 22:26:45 +00:00
< / pre >
2020-04-20 22:26:08 +00:00
< ul class = "endnotetexts" > < li > The structure web_bibliographic_datum is accessed in 2/dl, 2/dct, 5/ee and here.< / li > < / ul > < p class = "inwebparagraph" > < a id = "SP2" > < / a > < b > § 2. < / b > We keep these in linked lists, and here's a convenient way to scan them:
2019-02-04 22:26:45 +00:00
< / p >
< pre class = "definitions" >
2020-04-20 22:26:08 +00:00
< span class = "definition-keyword" > define< / span > < span class = "identifier-syntax" > LOOP_OVER_BIBLIOGRAPHIC_DATA< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > web_bibliographic_datum< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > bibliographic_data< / span > < span class = "plain-syntax" > )< / span >
2019-02-04 22:26:45 +00:00
< / pre >
< p class = "inwebparagraph" > < a id = "SP3" > < / a > < b > § 3. < / b > The following check the rules:
< / p >
< pre class = "display" >
2020-04-20 22:26:08 +00:00
< span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Bibliographic::datum_can_be_declared< / span > < button class = "popup" onclick = "togglePopup('usagePopup1')" > ...< span class = "popuptext" id = "usagePopup1" > Usage of < b > Bibliographic::datum_can_be_declared< / b > :< br > Web Structure - < a href = "8-ws.html#SP7_3_2_1" > § 7.3.2.1< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > web_md< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > key< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > web_bibliographic_datum< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP6" class = "internal" > Bibliographic::look_up_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > key< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "constant-syntax" > FALSE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > declaration_permitted< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Bibliographic::datum_on_or_off< / span > < button class = "popup" onclick = "togglePopup('usagePopup2')" > ...< span class = "popuptext" id = "usagePopup2" > Usage of < b > Bibliographic::datum_on_or_off< / b > :< br > Web Structure - < a href = "8-ws.html#SP7_3_2_1" > § 7.3.2.1< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > web_md< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > key< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > web_bibliographic_datum< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP6" class = "internal" > Bibliographic::look_up_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > key< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "constant-syntax" > FALSE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > on_or_off< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2019-02-04 22:26:45 +00:00
< / pre >
< p class = "inwebparagraph" > < a id = "SP4" > < / a > < b > § 4. Initialising a web. < / b > Each web has the following slate of data:
< / p >
< pre class = "display" >
2020-04-20 22:26:08 +00:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Bibliographic::initialise_data< / span > < button class = "popup" onclick = "togglePopup('usagePopup3')" > ...< span class = "popuptext" id = "usagePopup3" > Usage of < b > Bibliographic::initialise_data< / b > :< br > Web Structure - < a href = "8-ws.html#SP5_1" > § 5.1< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > web_md< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > web_bibliographic_datum< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Title"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ); < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > declaration_mandatory< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > TRUE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Author"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ); < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > declaration_mandatory< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > TRUE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Language"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "None"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Purpose"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > ""< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "License"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > alias< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Licence"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ); < / span > < span class = "comment" > alias US to UK spelling< / span >
< span class = "plain-syntax" > < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Short Title"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Capitalized Title"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Build Date"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Build Number"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Prerelease"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Semantic Version Number"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Version Number"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "1"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Version Name"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Index Template"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Preform Language"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Declare Section Usage"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Off"< / span > < span class = "plain-syntax" > ); < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > on_or_off< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > TRUE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Namespaces"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Off"< / span > < span class = "plain-syntax" > ); < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > on_or_off< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > TRUE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Sequential Section Ranges"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Off"< / span > < span class = "plain-syntax" > ); < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > on_or_off< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > TRUE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Strict Usage Rules"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Off"< / span > < span class = "plain-syntax" > ); < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > on_or_off< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > TRUE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "TeX Mathematics Notation"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "$"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "TeX Mathematics Displayed Notation"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "$$"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "TeX Mathematics Plugin"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "MathJax3"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Footnote Begins Notation"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "["< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Footnote Ends Notation"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "]"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Footnotes Plugin"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Bigfoot"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Code In Commentary Notation"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "|"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Code In Code Comments Notation"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "|"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Cross-References Notation"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "//"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Web Syntax Version"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
2019-02-04 22:26:45 +00:00
< / pre >
< p class = "inwebparagraph" > < a id = "SP5" > < / a > < b > § 5. < / b > Once the declarations for a web have been processed, the following is called
to check that all the mandatory declarations have indeed been made:
< / p >
< pre class = "display" >
2020-04-20 22:26:08 +00:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Bibliographic::check_required_data< / span > < button class = "popup" onclick = "togglePopup('usagePopup4')" > ...< span class = "popuptext" id = "usagePopup4" > Usage of < b > Bibliographic::check_required_data< / b > :< br > Web Structure - < a href = "8-ws.html#SP5_3" > § 5.3< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > web_md< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > web_bibliographic_datum< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER_BIBLIOGRAPHIC_DATA< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > ((< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > declaration_mandatory< / span > < span class = "plain-syntax" > ) & & < / span >
< span class = "plain-syntax" > (< / span > < a href = "4-sm.html#SP8" class = "internal" > Str::len< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > value< / span > < span class = "plain-syntax" > ) == < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ))< / span >
< span class = "plain-syntax" > < / span > < a href = "3-em.html#SP2" class = "internal" > Errors::fatal_with_text< / a > < span class = "plain-syntax" > (< / span >
< span class = "plain-syntax" > < / span > < span class = "string-syntax" > "The web does not specify '%S: ...'"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > key< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
2019-02-04 22:26:45 +00:00
< / pre >
< p class = "inwebparagraph" > < a id = "SP6" > < / a > < b > § 6. Reading bibliographic data. < / b > Key names are case-sensitive.
< / p >
< pre class = "display" >
2020-04-20 22:26:08 +00:00
< span class = "reserved-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Bibliographic::get_datum< / span > < button class = "popup" onclick = "togglePopup('usagePopup5')" > ...< span class = "popuptext" id = "usagePopup5" > Usage of < b > Bibliographic::get_datum< / b > :< br > Web Structure - < a href = "8-ws.html#SP5_4" > § 5.4< / a > , < a href = "8-ws.html#SP7_3_3_2_1" > § 7.3.3.2.1< / a > , < a href = "8-ws.html#SP7_2_2_3_1" > § 7.2.2.3.1< / a > < br> Build Files - < a href = "8-bf.html#SP6" > § 6< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > web_md< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > key< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > web_bibliographic_datum< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP6" class = "internal" > Bibliographic::look_up_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > key< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > ) < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > value< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Bibliographic::data_exists< / span > < button class = "popup" onclick = "togglePopup('usagePopup6')" > ...< span class = "popuptext" id = "usagePopup6" > Usage of < b > Bibliographic::data_exists< / b > :< br > none< / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > web_md< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > key< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > web_bibliographic_datum< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP6" class = "internal" > Bibliographic::look_up_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > key< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > ((< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > ) & & (< / span > < a href = "4-sm.html#SP8" class = "internal" > Str::len< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > value< / span > < span class = "plain-syntax" > ) > < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > )) < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "constant-syntax" > TRUE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "constant-syntax" > FALSE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< span class = "reserved-syntax" > web_bibliographic_datum< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Bibliographic::look_up_datum< / span > < button class = "popup" onclick = "togglePopup('usagePopup7')" > ...< span class = "popuptext" id = "usagePopup7" > Usage of < b > Bibliographic::look_up_datum< / b > :< br > < a href = "8-bdfw.html#SP3" > § 3< / a > , < a href = "8-bdfw.html#SP7" > § 7< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > web_md< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > key< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > web_bibliographic_datum< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER_BIBLIOGRAPHIC_DATA< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < a href = "4-sm.html#SP19" class = "internal" > Str::eq< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > key< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > key< / span > < span class = "plain-syntax" > )) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > alias< / span > < span class = "plain-syntax" > ) < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > alias< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2019-02-04 22:26:45 +00:00
< / pre >
< p class = "inwebparagraph" > < a id = "SP7" > < / a > < b > § 7. Writing bibliographic data. < / b > Note that a key-value pair is created if the key doesn't exist at present,
so this routine never fails.
< / p >
< pre class = "display" >
2020-04-20 22:26:08 +00:00
< span class = "reserved-syntax" > web_bibliographic_datum< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Bibliographic::set_datum< / span > < button class = "popup" onclick = "togglePopup('usagePopup8')" > ...< span class = "popuptext" id = "usagePopup8" > Usage of < b > Bibliographic::set_datum< / b > :< br > < a href = "8-bdfw.html#SP4" > § 4< / a > , < a href = "8-bdfw.html#SP7_2" > § 7.2< / a > , Web Structure - < a href = "8-ws.html#SP7_3_2_1" > § 7.3.2.1< / a > < br> Build Files - < a href = "8-bf.html#SP5" > § 5< / a > , < a href = "8-bf.html#SP6" > § 6< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > web_md< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > key< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > val< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > web_bibliographic_datum< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < a href = "8-bdfw.html#SP6" class = "internal" > Bibliographic::look_up_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > key< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) < / span > < < span class = "named-paragraph" > Create a new datum, then< / span > < span class = "named-paragraph-number" > 7.1< / span > >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > else< / span > < span class = "plain-syntax" > < / span > < a href = "4-sm.html#SP17" class = "internal" > Str::copy< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > value< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > val< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < a href = "4-sm.html#SP22" class = "internal" > Str::eq_wide_string< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > key< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "Title"< / span > < span class = "plain-syntax" > )) < / span > < < span class = "named-paragraph" > Also set a capitalized form< / span > < span class = "named-paragraph-number" > 7.2< / span > > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2019-02-04 22:26:45 +00:00
< / pre >
< p class = "inwebparagraph" > < a id = "SP7_1" > < / a > < b > § 7.1. < / b > < code class = "display" >
2020-04-20 22:26:08 +00:00
< < span class = "named-paragraph-defn" > Create a new datum, then< / span > < span class = "named-paragraph-number" > 7.1< / span > > =
2019-02-04 22:26:45 +00:00
< / code > < / p >
2020-04-20 22:26:08 +00:00
< pre class = "display" >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > CREATE< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > web_bibliographic_datum< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > key< / span > < span class = "plain-syntax" > = < / span > < a href = "4-sm.html#SP3" class = "internal" > Str::duplicate< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > key< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > value< / span > < span class = "plain-syntax" > = < / span > < a href = "4-sm.html#SP3" class = "internal" > Str::duplicate< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > val< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > declaration_mandatory< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > FALSE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > declaration_permitted< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > TRUE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > on_or_off< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > FALSE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > alias< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > ADD_TO_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > bd< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > web_bibliographic_datum< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > bibliographic_data< / span > < span class = "plain-syntax" > );< / span >
2019-02-04 22:26:45 +00:00
< / pre >
2020-04-20 22:26:08 +00:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "8-bdfw.html#SP7" > § 7< / a > .< / li > < / ul > < p class = "inwebparagraph" > < a id = "SP7_2" > < / a > < b > § 7.2. < / b > A slightly foolish feature, this; if text like "Wuthering Heights" is
2019-02-04 22:26:45 +00:00
written to the "Title" key, then a full-caps "WUTHERING HEIGHTS" is
written to a "Capitalized Title" key. (This enables cover sheets which
want to typeset the title in full caps to do so.)
< / p >
< p class = "macrodefinition" > < code class = "display" >
2020-04-20 22:26:08 +00:00
< < span class = "named-paragraph-defn" > Also set a capitalized form< / span > < span class = "named-paragraph-number" > 7.2< / span > > =
2019-02-04 22:26:45 +00:00
< / code > < / p >
2020-04-20 22:26:08 +00:00
< pre class = "display" >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > TEMPORARY_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > recapped< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "4-sm.html#SP17" class = "internal" > Str::copy< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > recapped< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > val< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_THROUGH_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > recapped< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < a href = "4-sm.html#SP14" class = "internal" > Str::put< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > toupper< / span > < span class = "plain-syntax" > (< / span > < a href = "4-sm.html#SP13" class = "internal" > Str::get< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > )));< / span >
< span class = "plain-syntax" > < / span > < a href = "8-bdfw.html#SP7" class = "internal" > Bibliographic::set_datum< / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Wm< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Capitalized Title"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > recapped< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > DISCARD_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > recapped< / span > < span class = "plain-syntax" > );< / span >
2019-02-04 22:26:45 +00:00
< / pre >
2020-04-20 22:26:08 +00:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "8-bdfw.html#SP7" > § 7< / a > .< / li > < / ul > < hr class = "tocbar" >
2020-04-02 12:30:38 +00:00
< ul class = "toc" > < li > < a href = "8-ws.html" > Back to 'Web Structure'< / a > < / li > < li > < a href = "8-wm.html" > Continue with 'Web Modules'< / a > < / li > < / ul > < hr class = "tocbar" >
2019-03-18 11:16:10 +00:00
<!-- End of weave -->
2020-03-19 00:03:04 +00:00
< / main >
2019-02-04 22:26:45 +00:00
< / body >
< / html >