Asciidoc markup improvement for vertical spacers

Asciidoc (deliberately) does not provide direct layout controls;
however, since we are publishing directly from Asciidoc markup,
at times ''we do require such controls''

A recurring pain point is that sometimes additional (vertical) whitespace
is required for better structuring a body of text; in the past I used various
tricks that turned out to be not reliable... And through exprimentation I have
now worked out a ''canonical solution''
 * Asciidoc provides a pre-defined page attribute `{nbsp}`
 * when used in a separate Paragraph, this generates an ''empty paragraph'' as spacer
This commit is contained in:
Fischlurch 2026-07-29 20:48:38 +02:00
parent e219dcbb8c
commit 777b1286fd
12 changed files with 90 additions and 68 deletions

View file

@ -156,10 +156,8 @@ the application itself.
_[aqua teal-background]#this is a mere idea, and certainly not a priority as of 2020#_
​{nbsp}
....
....
Lifecycle

View file

@ -200,9 +200,9 @@ Instead, Ticket https://issues.lumiera.org/ticket/1212[#1212 »Extension Concept
was added to the list of relevant
https://issues.lumiera.org/report/17[»Focus Topics«] for further development.
.........
​{nbsp}
.........
​{nbsp}
''''
Back to link:/x/DesignProcess.html[Lumiera Design Process overview]

View file

@ -87,10 +87,11 @@ textual replacements and environment variables, rather looking for ways to
record any application of rules or facts in the global _Event Log._
Ichthyostega:: '2025-09-20'
....
​
​
....
​{nbsp}
​{nbsp}
~What follows below is extended documentation for _Cehteh_'s Config System proposal...~

View file

@ -134,11 +134,13 @@ We have now a ``compatibility wiki'', finalized this proposal
ct:: '2008-03-26T13:43:26Z'
''''
....
​
​
​
....
​{nbsp}
​{nbsp}
​{nbsp}
Assessment 2025
~~~~~~~~~~~~~~~

View file

@ -47,11 +47,13 @@ Made this `final', this proposal got accepted and is already in use without
much discussion
ct:: '2007-06-27T16:07:13Z'
....
​
​
​
....
​{nbsp}
​{nbsp}
​{nbsp}
[large]#🌑 ​ 🌒 ​ 🌓 ​ 🌔 ​ 🌕 ​ 🌖 ​ 🌗 ​ 🌘 ​ 🌑#
[underline]#Historical remark#: This was ultimately the first

View file

@ -120,11 +120,13 @@ struct budget
------------------------------------------------------------------------------
ct:: '2010-07-23 20:55:49 CEST'
....
​
​
​
....
​{nbsp}
​{nbsp}
​{nbsp}
[[caveat]]

View file

@ -181,11 +181,13 @@ struct profile
------------------------------------------------------------------------------
ct:: '2010-07-23 20:33:13 CEST'
....
​
​
​
....
​{nbsp}
​{nbsp}
​{nbsp}
[[caveat]]

View file

@ -33,13 +33,16 @@ We decided to use a TiddlyWiki for now until this is further worked out
ct:: '2008-03-08T03:38:50Z'
....
​
​
​
​
​
....
​{nbsp}
​{nbsp}
​{nbsp}
​{nbsp}
​{nbsp}
.looking back at another era...
What shall I say, just Whew! 😖

View file

@ -124,11 +124,13 @@ Special _alias targets_ may be defined, based on other targets, to set off stand
build sequences. Notably, a _default_ target can be defined for the build.
''''
....
​
​
​
....
​{nbsp}
​{nbsp}
​{nbsp}
Organisation of the Lumiera SCons build

View file

@ -201,11 +201,13 @@ cache xref:caching[<-] and profiling xref:profiling[<-].
// ################################################
''''''''
....
​
​
​
....
​{nbsp}
​{nbsp}
​{nbsp}
The visible Universe
@ -351,11 +353,13 @@ purposes, and the contents of a clip bin can be played like a storyboard.
// ################################################
''''''''
....
​
​
​
....
​{nbsp}
​{nbsp}
​{nbsp}
Dark Matter
@ -552,11 +556,13 @@ Integration with external libraries, frameworks and applications
[red]#to be written#
''''''''
....
​
​
​
....
​{nbsp}
​{nbsp}
​{nbsp}
Further reading

View file

@ -280,12 +280,14 @@ TIP: The `mk-build-deps` tool reads the package manifest and fabricates a
''''
~What follows is background information and configuration for advanced users.~ +
^💡 You can safely skip and ignore the remainder of this page if in doubt.^
....
​
​
​
​
....
​{nbsp}
​{nbsp}
​{nbsp}
​{nbsp}

View file

@ -315,11 +315,13 @@ Current goals of development::
''''
....
​
​
​
....
​{nbsp}
​{nbsp}
​{nbsp}
Do you have any further ideas?