<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
<p>Please see in-line comments.</p>
<p>Don</p>
<p><br>
</p>
<div class="moz-cite-prefix">On 1/4/2023 2:06 AM, Gilles Caulier
wrote:<br>
</div>
<blockquote type="cite"
cite="mid:CAHFG6sFLgEhU_zpeNgP=RpztMRdDWCYHGsJR2oz1XY8ZCON8Bg@mail.gmail.com">
<pre class="moz-quote-pre" wrap="">Le mer. 4 janv. 2023 à 08:03, Gilles Caulier
<a class="moz-txt-link-rfc2396E" href="mailto:caulier.gilles@gmail.com"><caulier.gilles@gmail.com></a> a écrit :
</pre>
<blockquote type="cite">
<pre class="moz-quote-pre" wrap="">
Le mer. 4 janv. 2023 à 02:30, 7mgte <a class="moz-txt-link-rfc2396E" href="mailto:7mgte@miniblue.net"><7mgte@miniblue.net></a> a écrit :
</pre>
<blockquote type="cite">
<pre class="moz-quote-pre" wrap="">
Gilles,
Two comments:
The first note on the Database Settings page ( » Setup Application » Database Settings ; <a class="moz-txt-link-freetext" href="https://docs.digikam.org/en/setup_application/database_settings.html">https://docs.digikam.org/en/setup_application/database_settings.html</a>) refers the user to the section "Introduction of digiKam Databases" for information regarding internal storage.
Is the a way to put a hot link to take the user to the page?
</pre>
</blockquote>
<pre class="moz-quote-pre" wrap="">
To put a hot link between what and what ?</pre>
</blockquote>
</blockquote>
<p><br>
</p>
<p>The reference to "Introduction of digiKam Databases" is in the
"Note" block located at the top of
<a class="moz-txt-link-freetext" href="https://docs.digikam.org/en/setup_application/database_settings.html">https://docs.digikam.org/en/setup_application/database_settings.html</a>.
The note refers the reader to "Introduction of digiKam
Databases". If the section "Introduction of digiKam Databases"
exists, a link in the note block would be helpful. If the
section "Introduction of digiKam Databases" does not exist, then
the note block at the top of
<a class="moz-txt-link-freetext" href="https://docs.digikam.org/en/setup_application/database_settings.html">https://docs.digikam.org/en/setup_application/database_settings.html</a>
should be reviewed and reworded or deleted. </p>
<p><br>
</p>
<blockquote type="cite"
cite="mid:CAHFG6sFLgEhU_zpeNgP=RpztMRdDWCYHGsJR2oz1XY8ZCON8Bg@mail.gmail.com">
<blockquote type="cite">
<pre class="moz-quote-pre" wrap="">
</pre>
<blockquote type="cite">
<pre class="moz-quote-pre" wrap="">Looking through the document, the only sections I found related to databases were '» Getting started » Database' and '» Maintenance Tools » Database Cleaning'. Neither provided much in the way of details about the structure of internal storage. Did I miss something?
</pre>
</blockquote>
<pre class="moz-quote-pre" wrap="">
Well, with this one:
<a class="moz-txt-link-freetext" href="https://docs.digikam.org/en/setup_application/database_settings.html">https://docs.digikam.org/en/setup_application/database_settings.html</a>
... all is explained in detail.
In all cases, the documentation will be improved. Now as the
ReStructuredText is so far more simpler than the DocBook dinosaur, it
will be faster to provide mature documentation.
</pre>
</blockquote>
</blockquote>
<p><br>
</p>
<p><a class="moz-txt-link-freetext" href="https://docs.digikam.org/en/setup_application/database_settings.html">https://docs.digikam.org/en/setup_application/database_settings.html</a>
is the page with the note referring to "Introduction of digiKam
Databases". If the note does indeed refer to the page on which
the note itself is located, then it is not needed.<br>
</p>
<p><br>
</p>
<p><br>
</p>
<blockquote type="cite"
cite="mid:CAHFG6sFLgEhU_zpeNgP=RpztMRdDWCYHGsJR2oz1XY8ZCON8Bg@mail.gmail.com">
<blockquote type="cite">
<pre class="moz-quote-pre" wrap="">
</pre>
<blockquote type="cite">
<pre class="moz-quote-pre" wrap="">
Does Sphinx/RestructuredText/DocUtils have any provision for directly generating an Adobe PDF file? If so, that would be a nice option for downloading.
</pre>
</blockquote>
<pre class="moz-quote-pre" wrap="">
yes, it can but not natively. In fact, in background, to convert to
another format, Latex is used somewhere...
By default EPUB is proposed de facto, not PDF. It's in my TODO list to
add PDF target in the CI/CD
</pre>
</blockquote>
</blockquote>
<p><br>
</p>
<p>Fantastic!<br>
</p>
<p><br>
</p>
<p><br>
</p>
<blockquote type="cite"
cite="mid:CAHFG6sFLgEhU_zpeNgP=RpztMRdDWCYHGsJR2oz1XY8ZCON8Bg@mail.gmail.com">
<pre class="moz-quote-pre" wrap="">
The Sphinx way to generate PDF is very limited. It's due to use Latex
in background. you can use Calibre to convert EPUB to PDF. I add a
section in at end of README file:
<a class="moz-txt-link-freetext" href="https://invent.kde.org/documentation/digikam-doc/-/blob/master/README.md">https://invent.kde.org/documentation/digikam-doc/-/blob/master/README.md</a>
Best
Gilles Caulier
</pre>
</blockquote>
</body>
</html>