[utilities/basket] doc: Simplify documentation installation system
Yuri Chornoivan
null at kde.org
Fri Jun 5 16:44:55 BST 2020
Git commit 754cbd7f8bd64f037bbbf214f5ad5f0c8bf3cd1b by Yuri Chornoivan.
Committed on 05/06/2020 at 15:44.
Pushed by yurchor into branch 'master'.
Simplify documentation installation system
M +4 -1 doc/CMakeLists.txt
D +0 -15 doc/en/CMakeLists.txt
D +0 -123 doc/en/index.docbook
T +123 -1 doc/index.docbook
https://invent.kde.org/utilities/basket/commit/754cbd7f8bd64f037bbbf214f5ad5f0c8bf3cd1b
diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt
index 3276587..3a217f8 100644
--- a/doc/CMakeLists.txt
+++ b/doc/CMakeLists.txt
@@ -1 +1,4 @@
-add_subdirectory(en)
+########### install files ###############
+
+
+kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${KDE_INSTALL_DOCBUNDLEDIR}/en SUBDIR basket)
diff --git a/doc/en/CMakeLists.txt b/doc/en/CMakeLists.txt
deleted file mode 100644
index 2ea7c3a..0000000
--- a/doc/en/CMakeLists.txt
+++ /dev/null
@@ -1,15 +0,0 @@
-
-include_directories(${QT_INCLUDES} )
-
-
-########### install files ###############
-
-
-kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR basket)
-
-
-
-#original Makefile.am contents follow:
-
-#KDE_DOCS = basket
-#KDE_LANG = en
diff --git a/doc/en/index.docbook b/doc/en/index.docbook
deleted file mode 100644
index 3055e67..0000000
--- a/doc/en/index.docbook
+++ /dev/null
@@ -1,123 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" ?>
-<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
- <!ENTITY basket "<application>BasKet</application>">
- <!ENTITY % addindex "IGNORE">
- <!ENTITY % English "INCLUDE" > <!-- change language only here -->
-]>
-
-<book id='basket' lang="&language;">
-
- <bookinfo>
- <title>The &basket; Handbook</title>
- <authorgroup>
- <author>
- <personname>
- <firstname>Gleb</firstname>
- <surname>Baryshev</surname>
- </personname>
- <email>gleb.baryshev at gmail.com</email>
- </author>
- </authorgroup>
- <date>2016-11-07</date>
- <releaseinfo>2.11</releaseinfo>
-
- <abstract>
- <para>Taking care of your ideas.</para>
- </abstract>
- <keywordset>
- <keyword>KDE</keyword>
- <keyword>BasKet</keyword>
- <!--keyword>note pad</keyword-->
- </keywordset>
- </bookinfo>
-
- <chapter id="notice">
- <title>NOTICE: handbook not written yet</title>
- <para>&basket; still does not have a handbook, so contributors are welcome!
- Check the <ulink url='https://l10n.kde.org/docs/doc-primer/index.html'>
- KDE documentation</ulink> for the hints on the DocBook format.</para>
- <para>Meanwhile, you can look for help on the Internet. In particular,
- look through the <ulink url='https://basket-notepads.github.io'>old website</ulink> or
- check Linux magazines if you have access to them, for example:
- <itemizedlist>
- <listitem><para>
- <quote>Tutorial: Basket: Capture your thoughts.</quote> Linux Format 120
- (Andy Channelle)
- </para></listitem>
- <listitem><para>
- <quote>A Virtual Basket. Storing, sorting, and filing with KDE's
- Basket</quote> Linux Magazine 54 (Stefanie Teufel)
- </para></listitem>
- </itemizedlist>
- </para>
- </chapter>
-
- <chapter id="introduction">
- <title>Introduction</title>
- <para>&basket; is mainly an all-purpose notes taker, but a particular one:</para>
- </chapter>
-
- <chapter id="using-BasKet">
- <title>Using BasKet</title>
- <para></para>
- <sect1>
- <title>Version Sync</title>
- <para>When enabled, Version Sync puts your baskets and notes under version control. Currently this is an experimental feature and only very basic functions are implemented, so it may require additional software and some manual setup. These are some of the things that can be done using external tools (but not Basket interface yet):</para>
- <itemizedlist>
- <listitem>
- <para>check out old revisions and revert the changes</para>
- </listitem>
- <listitem>
- <para>synchronize baskets on several computers (merge the changes)</para>
- </listitem>
- <listitem>
- <para>push baskets backup to remote repository</para>
- </listitem>
- </itemizedlist>
- <para>To enable it, select
- <menuchoice>
- <guimenu>Settings</guimenu> <guimenuitem>Configure BasKet Note Pads</guimenuitem>
- </menuchoice>
- → <guibutton>Version Sync</guibutton>
- and <guibutton>Enable distributed version control</guibutton>. It will initialize git repository in <filename>~/.kde/share/apps/basket/baskets</filename>, upon which standard git tools can be used.</para>
- <sect2>
- <title>Clearing version history</title>
- <para>Clearing the history can be useful in these cases:</para>
- <itemizedlist>
- <listitem>
- <para>you have locked a basket and want to remove any previous unencrypted versions (which are still stored in the system)</para>
- </listitem>
- <listitem>
- <para>you want to free some disk space (can be topical if you insert a lot of images or other files into Basket)</para>
- </listitem>
- </itemizedlist>
- <para>Note that you will have to redo any manual setup you did on the git repository.</para>
- </sect2>
- </sect1>
- </chapter>
-
- <chapter id="questions-answers-and-tips">
- <title>Questions, Answers, and Tips</title>
-
- <qandaset id="faq">
- <title>Frequently asked questions</title>
- <qandaentry>
- <question>
- <para>Question 1</para>
- </question>
- <answer>
- <para>The answer</para>
- </answer>
- </qandaentry>
- </qandaset>
-
- </chapter>
-</book>
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag: nil
-sgml-shorttag: t
-sgml-general-insert-case: lower
-End:
--->
diff --git a/doc/index.docbook b/doc/index.docbook
deleted file mode 120000
index 9c81de4..0000000
--- a/doc/index.docbook
+++ /dev/null
@@ -1 +0,0 @@
-en/index.docbook
\ No newline at end of file
diff --git a/doc/index.docbook b/doc/index.docbook
new file mode 100644
index 0000000..3055e67
--- /dev/null
+++ b/doc/index.docbook
@@ -0,0 +1,123 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
+ <!ENTITY basket "<application>BasKet</application>">
+ <!ENTITY % addindex "IGNORE">
+ <!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<book id='basket' lang="&language;">
+
+ <bookinfo>
+ <title>The &basket; Handbook</title>
+ <authorgroup>
+ <author>
+ <personname>
+ <firstname>Gleb</firstname>
+ <surname>Baryshev</surname>
+ </personname>
+ <email>gleb.baryshev at gmail.com</email>
+ </author>
+ </authorgroup>
+ <date>2016-11-07</date>
+ <releaseinfo>2.11</releaseinfo>
+
+ <abstract>
+ <para>Taking care of your ideas.</para>
+ </abstract>
+ <keywordset>
+ <keyword>KDE</keyword>
+ <keyword>BasKet</keyword>
+ <!--keyword>note pad</keyword-->
+ </keywordset>
+ </bookinfo>
+
+ <chapter id="notice">
+ <title>NOTICE: handbook not written yet</title>
+ <para>&basket; still does not have a handbook, so contributors are welcome!
+ Check the <ulink url='https://l10n.kde.org/docs/doc-primer/index.html'>
+ KDE documentation</ulink> for the hints on the DocBook format.</para>
+ <para>Meanwhile, you can look for help on the Internet. In particular,
+ look through the <ulink url='https://basket-notepads.github.io'>old website</ulink> or
+ check Linux magazines if you have access to them, for example:
+ <itemizedlist>
+ <listitem><para>
+ <quote>Tutorial: Basket: Capture your thoughts.</quote> Linux Format 120
+ (Andy Channelle)
+ </para></listitem>
+ <listitem><para>
+ <quote>A Virtual Basket. Storing, sorting, and filing with KDE's
+ Basket</quote> Linux Magazine 54 (Stefanie Teufel)
+ </para></listitem>
+ </itemizedlist>
+ </para>
+ </chapter>
+
+ <chapter id="introduction">
+ <title>Introduction</title>
+ <para>&basket; is mainly an all-purpose notes taker, but a particular one:</para>
+ </chapter>
+
+ <chapter id="using-BasKet">
+ <title>Using BasKet</title>
+ <para></para>
+ <sect1>
+ <title>Version Sync</title>
+ <para>When enabled, Version Sync puts your baskets and notes under version control. Currently this is an experimental feature and only very basic functions are implemented, so it may require additional software and some manual setup. These are some of the things that can be done using external tools (but not Basket interface yet):</para>
+ <itemizedlist>
+ <listitem>
+ <para>check out old revisions and revert the changes</para>
+ </listitem>
+ <listitem>
+ <para>synchronize baskets on several computers (merge the changes)</para>
+ </listitem>
+ <listitem>
+ <para>push baskets backup to remote repository</para>
+ </listitem>
+ </itemizedlist>
+ <para>To enable it, select
+ <menuchoice>
+ <guimenu>Settings</guimenu> <guimenuitem>Configure BasKet Note Pads</guimenuitem>
+ </menuchoice>
+ → <guibutton>Version Sync</guibutton>
+ and <guibutton>Enable distributed version control</guibutton>. It will initialize git repository in <filename>~/.kde/share/apps/basket/baskets</filename>, upon which standard git tools can be used.</para>
+ <sect2>
+ <title>Clearing version history</title>
+ <para>Clearing the history can be useful in these cases:</para>
+ <itemizedlist>
+ <listitem>
+ <para>you have locked a basket and want to remove any previous unencrypted versions (which are still stored in the system)</para>
+ </listitem>
+ <listitem>
+ <para>you want to free some disk space (can be topical if you insert a lot of images or other files into Basket)</para>
+ </listitem>
+ </itemizedlist>
+ <para>Note that you will have to redo any manual setup you did on the git repository.</para>
+ </sect2>
+ </sect1>
+ </chapter>
+
+ <chapter id="questions-answers-and-tips">
+ <title>Questions, Answers, and Tips</title>
+
+ <qandaset id="faq">
+ <title>Frequently asked questions</title>
+ <qandaentry>
+ <question>
+ <para>Question 1</para>
+ </question>
+ <answer>
+ <para>The answer</para>
+ </answer>
+ </qandaentry>
+ </qandaset>
+
+ </chapter>
+</book>
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+sgml-general-insert-case: lower
+End:
+-->
More information about the kde-doc-english
mailing list