DocBook Format Trial

This is a trial of the Docbook Format.  And it didn't end up working
out.  This is fine.
This commit is contained in:
Jigme Datse Yli-Rasku 2023-10-20 22:34:47 -07:00
parent eb1342b239
commit d923c3349c
10 changed files with 4466 additions and 335 deletions

Binary file not shown.

View File

@ -1,4 +1,135 @@
<appendix>
<title>Apppendix — Appendix</title>
<para>This is the first paragraph</para>
<title>Appendix — Notes</title>
<section xml:id="october-6">
<title>2023 October 6</title>
<para>
Created the Appendix it includes:
</para>
<itemizedlist>
<listitem>
<para>
Introduction — Notes
</para>
</listitem>
<listitem>
<para>
Characters — Notes
</para>
</listitem>
<listitem>
<para>
Appendix — Notes
</para>
</listitem>
</itemizedlist>
<para>
It probably will have an index at some point, but currently we
dont have a way that we want to note things in the index, or even
much of an idea of how to we would even index things.
</para>
<para>
I feel that Ill for now put some technical stuff about the whole
thing in this index.
</para>
<section xml:id="arrangement-of-chapters">
<title>Arrangement of Chapters</title>
<para>
Currently we have Introduction and Characters, then the Appendix
in the same order. But that might not continue as such. Moving
stuff around probably will need to be noted here.
</para>
<para>
As it currently stands the &quot;Hero&quot; or Character chapter
is really hard to find stuff in the file as its 500 lines long,
and it just takes a while to scroll through it.
</para>
</section>
<section xml:id="line-lengths">
<title>Line lengths</title>
<para>
Also, these long lines... Or what are paragraphs as a single
line in the file, need to go as I come across them. It would be
nice if it actually did it automatically. As this file currently
is, it is 23 lines long, but it has multiple longer paragraphs
formatted that way.
</para>
<para>
After adding new lines, I end up with …35 lines. Thats a more
realistic way to look at it. Also, it can help with finding
where more specific errors are, as the long lines will be more
listed as a single line, but the shorter lines can be each
listed.
</para>
<para>
The problem Ive run into is reformatting when I end up changing
a line in the middle of a paragraph. All of that can be handled
on an as needed basis though.
</para>
</section>
<section xml:id="makefile">
<title>Makefile</title>
<para>
This isnt so much the book itself, but it is kind of important.
I have a Makefile created which hopefully allows the creation of
the book at least for display purposes. I
<emphasis>think</emphasis> the reason that the table of contents
wasnt correct, is because it needs to run through twice, or at
least it <emphasis>might</emphasis> need to run through twice,
to have the updates in the table of contents (and index I
think).
</para>
</section>
<section xml:id="closing-thoughts">
<title>Closing Thoughts</title>
<para>
Most of what I have done in terms of this has been to just
finish with notes on the changes for the day in the other
sections of the appendix. I know that I have some notes here
that should be dealt with better. Ill get to them. I promise...
</para>
</section>
</section>
<section xml:id="october-7">
<title>2023 October 7</title>
<para>
Mostly not doing much of anything today, but I decided to throw
here a little playing with the LaTeXand a more
&quot;authentic&quot; version...
</para>
<para>
LaTeX
</para>
<para>
$\Lambda\kern-0.1667em\raise.5ex\hbox{$\alpha$}\kern -.0625em\raise.5ex\hbox{$T\kern -.25em\lower.5ex\hbox{$\epsilon$}\kern -.125em \chi$}$
</para>
<para>
These are just silly playing, but I feel they are worth keeping
here for now.
</para>
</section>
<section>
<title>2023 October 20</title>
<para>
I haven't worked on this much for a while. There is a bit of a major change in what I'm doing here. I decided that I wanted to have more flexibility in my output formats (someone mentioned markdown as a format for print documents using Pandoc), so I have converted the previous version to DocBook, which I'm currently able to create a LaTeX file, which I can create a
PDF from.
</para>
<para>
This is an improvement in many ways, as I hope that will make converting it to something like an epub or html document easier. Though I'm not convinced of that yet.
</para>
<para>
In some ways it is a lot worse though. The PDF currently being produced is much worse. Working in DocBook, is harder than working in LaTeX. A lot of the formatting that was for LaTeX is lost, and may be a huge pain to restore in the end.
</para>
<para>
While some of the formatting I did have was just not working, or not working well. I had something that I could "work with." This so far, is a step backwards, for reasons that don't entirely make sense to me.
</para>
<para>
Well, not entirely make sense to me, as in I don't see that this will end up being a better option in the end.
</para>
<para>
So, I feel what I'm going to probably aim to do, is copy this change here, back to the LaTeX version. If I'm going to do other versions, do the conversion based on that. The current LaTeX version is actually preferable. That is a worthwhile thing to have figured out.
</para>
<para>
Also, I think having a working workflow to the point I currently have it, is also worthwhile, as it is certainly going to make things easier to handle when (and if), I decided to produce a different format than the LaTeX PDF/Print version.
</para>
</section>
</appendix>

View File

@ -1,4 +1,38 @@
<appendix>
<title>Appendix — Chararacters</title>
<para>This is the first paragraph</para>
<title>Characters — Notes</title>
<section xml:id="section">
<title>2023-10-06</title>
<para>
Created This…Already had a good portion of the chapter written.
</para>
<para>
The first character was getting close to having been created, and
that was working well, but I cant work on it further at this
time, but wanted to put some info here to make the whole document
work a little better.
</para>
<para>
At this point I need to do more away from the computer to get an
idea of the next steps for the character creation. It looks to be
at the Step 4. Skills section.
</para>
<section xml:id="further-work">
<title>Further Work</title>
<para>
A lot of what has been done is moving toward better formatting.
I took a break because I wanted to take a look away from the
computer at the Step 5. Advantages part of character creation.
</para>
<para>
I did move beyond that, but its not reflected here yet. I also
want to have the character sheet info, and the character
building info.
</para>
<para>
Just did some minor changes to make it less a massive wall of
Character Sheet, followed by Character Creation, followed by
Character Notes. Those are different sections now.
</para>
</section>
</section>
</appendix>

View File

@ -1,4 +1,17 @@
<appendix>
<title>Appendix — Introduction</title>
<para>This is the first paragraph</para>
<title>Introduction — Notes</title>
<section xml:id="section">
<title>2023-10-06</title>
<para>
Created the Introduction chapter. This was already starting to
look like I was going to need an introduction before too long, so
there is a brief introduction and some about each of the parts
that we have there.
</para>
<para>
It will likely need to be expanded and made more a way to get a
fairly quick idea as to where something might be. All of this will
take time.
</para>
</section>
</appendix>

View File

@ -1,221 +0,0 @@
\FOT{3}\Seq%
{\def\PageNumberFormat%
{1}\def\PageNumberRestart%
{0}\def\PageTwoSide%
{0}\def\TwoSideStartOnRight%
{0}\def\PageNColumns%
{1}\def\PageColumnSep%
{36\p@}\def\PageBalanceColumns%
{0}\def\WritingMode%
{lefttoright}\def\InputWhitespaceTreatment%
{collapse}\def\LeftMargin%
{72\p@}\def\RightMargin%
{72\p@}\def\PageWidth%
{612\p@}\def\PageHeight%
{792\p@}\def\MinLeading%
{2\p@}\def\MinLeadingFactor%
{0}\def\TopMargin%
{72\p@}\def\BottomMargin%
{96\p@}\def\HeaderMargin%
{48\p@}\def\FooterMargin%
{48\p@}}\Node%
{}\Node%
{\def\Element%
{0}}\Seq%
{}\SpS%
{\def\PageNColumns%
{1}\def\InputWhitespaceTreatment%
{collapse}\def\fSize%
{10\p@}\def\fWeight%
{medium}\def\fPosture%
{upright}\def\fFamName{Times-New-Roman}\def\LineSpacing%
{13\p@}\def\LineSpacingFactor%
{0}}
\SpSOtherBackLeftFooter%
{}
\SpSOtherBackLeftHeader%
{}
\SpSOtherBackCenterFooter%
{}
\SpSOtherBackCenterHeader%
{}
\SpSOtherBackRightFooter%
{}
\SpSOtherBackRightHeader%
{}
\SpSFirstBackLeftFooter%
{}
\SpSFirstBackLeftHeader%
{}
\SpSFirstBackCenterFooter%
{}
\SpSFirstBackCenterHeader%
{}
\SpSFirstBackRightFooter%
{}
\SpSFirstBackRightHeader%
{}
\SpSOtherFrontLeftFooter%
{}
\SpSOtherFrontLeftHeader%
{}
\SpSOtherFrontCenterFooter%
{}
\SpSOtherFrontCenterHeader%
{}
\SpSOtherFrontRightFooter%
{}
\SpSOtherFrontRightHeader%
{}
\SpSFirstFrontLeftFooter%
{}
\SpSFirstFrontLeftHeader%
{}
\SpSFirstFrontCenterFooter%
{}
\SpSFirstFrontCenterHeader%
{}
\SpSFirstFrontRightFooter%
{}
\SpSFirstFrontRightHeader%
{}\Seq%
{}\Par%
{\def\LineSpacing%
{1\p@}\def\LineSpacingFactor%
{0}}\endPar{}\Seq%
{}\Node%
{\def\Element%
{1}\def\ProcessingMode%
{book-titlepage-recto-mode}}\HeadPar%
{\def\fSize%
{24.883\p@}\def\LineSpacing%
{32.348\p@}\def\LineSpacingFactor%
{0}\def\Quadding%
{center}\def\HeadingLevel%
{1}\def\fFamName{Arial}\def\fWeight%
{bold}\def\sbNom%
{18.662\p@}\def\sbMin%
{18.662\p@}\def\sbMax%
{18.662\p@}\def\sbConditional%
{1}\def\KeepWithNext%
{1}}7th Sea Resources\def\HeadingText{%
7th Sea Resources}%
\endHeadPar{}\endNode{}\endSeq{}\endSeq{}\DisplayGroup%
{\def\BreakBefore%
{page}}\Seq%
{}\Par%
{\def\LineSpacing%
{1\p@}\def\LineSpacingFactor%
{0}}\endPar{}\Seq%
{}\Node%
{\def\Element%
{1}\def\ProcessingMode%
{book-titlepage-verso-mode}}\Seq%
{\def\fFamName{Arial}\def\fWeight%
{bold}}7th Sea Resources\endSeq{}\endNode{}\endSeq{}\endSeq{}\endDisplayGroup{}\endSpS{}\SpS%
{\def\PageNColumns%
{1}\def\PageNumberFormat%
{i}\def\InputWhitespaceTreatment%
{collapse}\def\fSize%
{10\p@}\def\fWeight%
{medium}\def\fPosture%
{upright}\def\fFamName{Times-New-Roman}\def\LineSpacing%
{13\p@}\def\LineSpacingFactor%
{0}}
\SpSOtherBackLeftFooter%
{}
\SpSOtherBackLeftHeader%
{}
\SpSOtherBackCenterFooter%
{}
\SpSOtherBackCenterHeader%
{}
\SpSOtherBackRightFooter%
{\Seq%
{\def\fPosture%
{italic}}\insertPageNumber%
{}\endSeq{}}
\SpSOtherBackRightHeader%
{}
\SpSFirstBackLeftFooter%
{}
\SpSFirstBackLeftHeader%
{}
\SpSFirstBackCenterFooter%
{}
\SpSFirstBackCenterHeader%
{}
\SpSFirstBackRightFooter%
{\Seq%
{\def\fPosture%
{italic}}\insertPageNumber%
{}\endSeq{}}
\SpSFirstBackRightHeader%
{}
\SpSOtherFrontLeftFooter%
{}
\SpSOtherFrontLeftHeader%
{}
\SpSOtherFrontCenterFooter%
{}
\SpSOtherFrontCenterHeader%
{}
\SpSOtherFrontRightFooter%
{\Seq%
{\def\fPosture%
{italic}}\insertPageNumber%
{}\endSeq{}}
\SpSOtherFrontRightHeader%
{}
\SpSFirstFrontLeftFooter%
{}
\SpSFirstFrontLeftHeader%
{}
\SpSFirstFrontCenterFooter%
{}
\SpSFirstFrontCenterHeader%
{}
\SpSFirstFrontRightFooter%
{\Seq%
{\def\fPosture%
{italic}}\insertPageNumber%
{}\endSeq{}}
\SpSFirstFrontRightHeader%
{}\endSpS{}\Node%
{\def\Element%
{1}}\endNode{}
\Node%
{\def\Element%
{2}}\Seq%
{\def\ColorRed%
{255}\def\ColorGreen%
{0}\def\ColorBlue%
{0}}include href="intro.xml" />\/
\Node%
{\def\Element%
{3}}\Seq%
{\def\ColorRed%
{255}\def\ColorGreen%
{0}\def\ColorBlue%
{0}}include href="chars.xml" />\/
\Node%
{\def\Element%
{4}}\Seq%
{\def\ColorRed%
{255}\def\ColorGreen%
{0}\def\ColorBlue%
{0}}include href="append-\/intro.xml" />\/
\Node%
{\def\Element%
{5}}\Seq%
{\def\ColorRed%
{255}\def\ColorGreen%
{0}\def\ColorBlue%
{0}}include href="append-\/chars.xml" />\/
\Node%
{\def\Element%
{6}}\Seq%
{\def\ColorRed%
{255}\def\ColorGreen%
{0}\def\ColorBlue%
{0}}include href="append-\/append.xml" />\/\endSeq{}\endNode{}\endSeq{}\endNode{}\endSeq{}\endNode{}\endSeq{}\endNode{}\endSeq{}\endNode{}\endSeq{}\endNode{}\endNode{}\endSeq{}\endFOT{}

File diff suppressed because it is too large Load Diff

View File

@ -1,86 +0,0 @@
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="introduction">
<title>Introduction</title>
<para>
This book is made based on the
<emphasis>7<superscript><emphasis>t</emphasis><emphasis>h</emphasis></superscript>
Sea Core Rulebook:
2<superscript><emphasis>n</emphasis><emphasis>d</emphasis></superscript>
Edition</emphasis>, and is mainly meant as something for putting
content that I am wanting to run together.
</para>
<para>
That said, this may become something that parts or the entirety of
it will get in the hands of my players, or people who find it some
other way. I may at some point decide to publish it.
</para>
<para>
As I am writing this very brief introduction I have something
written about Characters, specifically the start of a single
Character. I dont really know where it will go beyond that.
</para>
<para>
2
</para>
<section xml:id="characters">
<title>Characters</title>
<para>
This is where the characters I create will go. Some of these may
be characters which Im creating for myself, and some may have
been just created for fun, and some might even be created for a
specific player.
</para>
<section xml:id="träge">
<title>???? Träge</title>
<para>
This is the first character I am creating, and as of now it has
a good amount about actually creating the character in the
sections labeled &quot;Step ...&quot;
</para>
<para>
There is also room for additional notes.
</para>
</section>
<section xml:id="references">
<title>References</title>
<para>
This contains some information which may (not yet), apply to
multiple characters. It also might be something which ends up
getting referred to in multiple places for a single character.
</para>
</section>
</section>
<section xml:id="appendix">
<title>Appendix</title>
<para>
This is where my notes about the process of this goes, as well as
possibly some stuff which might make it easier to find your (my)
way through this. Each chapter will have a separate appendix, in
part just for making it easier to edit.
</para>
<para>
This also is including stuff about the whole process of making the
book itself.
</para>
<section xml:id="introduction-notes">
<title>Introduction — Notes</title>
<para>
This is content about what Ive put in the introduction section
(the one youre reading).
</para>
</section>
<section xml:id="characters-notes">
<title>Characters — Notes</title>
<para>
This is notes on the character section. Its more of the
technical stuff than what would go here.
</para>
</section>
<section xml:id="appendix-notes">
<title>Appendix — Notes</title>
<para>
This is notes more about the whole overall process, and stuff
that has gone on with the appendix itself.
</para>
</section>
</section>
</section>

View File

@ -1,4 +1,82 @@
<chapter>
<title>Introduction</title>
<para>This is the first paragraph</para>
<para>
This book is made based on the
<emphasis>7<superscript>th</superscript> Sea Core Rulebook:
2<superscript>nd</superscript> Edition</emphasis>, and is mainly
meant as something for putting content that I am wanting to run
together.
</para>
<para>
That said, this may become something that parts or the entirety of
it will get in the hands of my players, or people who find it some
other way. I may at some point decide to publish it.
</para>
<para>
As I am writing this very brief introduction I have something
written about Characters, specifically the start of a single
Character. I dont really know where it will go beyond that.
</para>
<section xml:id="characters">
<title>Characters</title>
<para>
This is where the characters I create will go. Some of these may
be characters which Im creating for myself, and some may have
been just created for fun, and some might even be created for a
specific player.
</para>
<section xml:id="träge">
<title>???? Träge</title>
<para>
This is the first character I am creating, and as of now it has
a good amount about actually creating the character in the
sections labeled &quot;Step ...&quot;
</para>
<para>
There is also room for additional notes.
</para>
</section>
<section xml:id="references">
<title>References</title>
<para>
This contains some information which may (not yet), apply to
multiple characters. It also might be something which ends up
getting referred to in multiple places for a single character.
</para>
</section>
</section>
<section xml:id="appendix">
<title>Appendix</title>
<para>
This is where my notes about the process of this goes, as well as
possibly some stuff which might make it easier to find your (my)
way through this. Each chapter will have a separate appendix, in
part just for making it easier to edit.
</para>
<para>
This also is including stuff about the whole process of making the
book itself.
</para>
<section xml:id="introduction-notes">
<title>Introduction — Notes</title>
<para>
This is content about what Ive put in the introduction section
(the one youre reading).
</para>
</section>
<section xml:id="characters-notes">
<title>Characters — Notes</title>
<para>
This is notes on the character section. Its more of the
technical stuff than what would go here.
</para>
</section>
<section xml:id="appendix-notes">
<title>Appendix — Notes</title>
<para>
This is notes more about the whole overall process, and stuff
that has gone on with the appendix itself.
</para>
</section>
</section>
</chapter>

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff