From 777b1286fdc7e36530f216a695003c6de2a4482f Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Wed, 29 Jul 2026 20:48:38 +0200 Subject: [PATCH] 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 --- doc/design/architecture/Subsystems.txt | 4 +-- doc/devel/rfc/AllPluginInterfacesAreC.txt | 4 +-- doc/devel/rfc/ConfigLoader.txt | 9 ++--- doc/devel/rfc/DevelopmentFramework.txt | 12 ++++--- .../rfc/DistributedDevelopmentFramework.txt | 12 ++++--- doc/devel/rfc/ResourceManagementBudgeting.txt | 12 ++++--- doc/devel/rfc/ResourceManagementProfiling.txt | 12 ++++--- doc/devel/rfc/TodoLists.txt | 19 +++++----- doc/technical/build/SCons.txt | 12 ++++--- doc/user/intro/intro.txt | 36 +++++++++++-------- doc/user/tutorials/DebianBuilding.txt | 14 ++++---- doc/user/tutorials/contributing.txt | 12 ++++--- 12 files changed, 90 insertions(+), 68 deletions(-) diff --git a/doc/design/architecture/Subsystems.txt b/doc/design/architecture/Subsystems.txt index 74e276d25..51f336ed1 100644 --- a/doc/design/architecture/Subsystems.txt +++ b/doc/design/architecture/Subsystems.txt @@ -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 diff --git a/doc/devel/rfc/AllPluginInterfacesAreC.txt b/doc/devel/rfc/AllPluginInterfacesAreC.txt index f79f4d1b5..9d625b227 100644 --- a/doc/devel/rfc/AllPluginInterfacesAreC.txt +++ b/doc/devel/rfc/AllPluginInterfacesAreC.txt @@ -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] diff --git a/doc/devel/rfc/ConfigLoader.txt b/doc/devel/rfc/ConfigLoader.txt index ca14143a8..ee1b0568a 100644 --- a/doc/devel/rfc/ConfigLoader.txt +++ b/doc/devel/rfc/ConfigLoader.txt @@ -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...~ diff --git a/doc/devel/rfc/DevelopmentFramework.txt b/doc/devel/rfc/DevelopmentFramework.txt index 8a4000f53..d4bd23b8e 100644 --- a/doc/devel/rfc/DevelopmentFramework.txt +++ b/doc/devel/rfc/DevelopmentFramework.txt @@ -134,11 +134,13 @@ We have now a ``compatibility wiki'', finalized this proposal ct:: '2008-03-26T13:43:26Z' '''' -.... -​ -​ -​ -.... + +​{nbsp} + +​{nbsp} + +​{nbsp} + Assessment 2025 ~~~~~~~~~~~~~~~ diff --git a/doc/devel/rfc/DistributedDevelopmentFramework.txt b/doc/devel/rfc/DistributedDevelopmentFramework.txt index e2d43d7cc..2d2dd43a7 100644 --- a/doc/devel/rfc/DistributedDevelopmentFramework.txt +++ b/doc/devel/rfc/DistributedDevelopmentFramework.txt @@ -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 diff --git a/doc/devel/rfc/ResourceManagementBudgeting.txt b/doc/devel/rfc/ResourceManagementBudgeting.txt index e4db5b5a4..41de433ef 100644 --- a/doc/devel/rfc/ResourceManagementBudgeting.txt +++ b/doc/devel/rfc/ResourceManagementBudgeting.txt @@ -120,11 +120,13 @@ struct budget ------------------------------------------------------------------------------ ct:: '2010-07-23 20:55:49 CEST' -.... -​ -​ -​ -.... + +​{nbsp} + +​{nbsp} + +​{nbsp} + [[caveat]] diff --git a/doc/devel/rfc/ResourceManagementProfiling.txt b/doc/devel/rfc/ResourceManagementProfiling.txt index a2c9c9e02..9d13b1fcb 100644 --- a/doc/devel/rfc/ResourceManagementProfiling.txt +++ b/doc/devel/rfc/ResourceManagementProfiling.txt @@ -181,11 +181,13 @@ struct profile ------------------------------------------------------------------------------ ct:: '2010-07-23 20:33:13 CEST' -.... -​ -​ -​ -.... + +​{nbsp} + +​{nbsp} + +​{nbsp} + [[caveat]] diff --git a/doc/devel/rfc/TodoLists.txt b/doc/devel/rfc/TodoLists.txt index e83eab89f..741367f24 100644 --- a/doc/devel/rfc/TodoLists.txt +++ b/doc/devel/rfc/TodoLists.txt @@ -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], diff --git a/doc/technical/build/SCons.txt b/doc/technical/build/SCons.txt index b5e24e1b3..228856113 100644 --- a/doc/technical/build/SCons.txt +++ b/doc/technical/build/SCons.txt @@ -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 diff --git a/doc/user/intro/intro.txt b/doc/user/intro/intro.txt index 2e49a6c27..bd2908d62 100755 --- a/doc/user/intro/intro.txt +++ b/doc/user/intro/intro.txt @@ -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 diff --git a/doc/user/tutorials/DebianBuilding.txt b/doc/user/tutorials/DebianBuilding.txt index de86c4432..5a20219c0 100644 --- a/doc/user/tutorials/DebianBuilding.txt +++ b/doc/user/tutorials/DebianBuilding.txt @@ -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} diff --git a/doc/user/tutorials/contributing.txt b/doc/user/tutorials/contributing.txt index 6fe451999..f1029bcee 100644 --- a/doc/user/tutorials/contributing.txt +++ b/doc/user/tutorials/contributing.txt @@ -315,11 +315,13 @@ Current goals of development:: '''' -.... -​ -​ -​ -.... + +​{nbsp} + +​{nbsp} + +​{nbsp} + Do you have any further ideas?