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! 😖
@ -53,7 +56,7 @@ to the community of other contributors, which would decide about what is viable,
just simply by merging or not merging -- and some clever tool could watch the
resulting commit stream and extract the minimum necessary accounting to
supply the developers with that amount of information
they need to be actually productive....
they need to be actually productive....
.State -> Dropped
Lumiera is quite another kind of project today. There _is_ a https://issues.lumiera.org/[Bugtracker],

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?