From dd581bd656a10e51b22ff7a7c2d6b55fb6c7d90a Mon Sep 17 00:00:00 2001 From: Darrell Anderson Date: Sun, 5 Oct 2014 10:50:02 -0500 Subject: [PATCH] Move Tutorials from tdebase. Add docbook & markup tutorials. Tutorials need editing and updating. Thus the default configuration is -DBUILD_TUTORIALS=OFF. --- CMakeLists.txt | 2 + doc/Makefile.am | 1 - doc/tutorials/CMakeLists.txt | 9 + doc/tutorials/Makefile.am | 4 + doc/tutorials/docprimer/CMakeLists.txt | 9 + doc/tutorials/docprimer/Makefile.am | 3 + doc/tutorials/docprimer/index.docbook | 2160 +++++++ doc/tutorials/docprimer/kate-plugin.png | Bin 0 -> 81275 bytes doc/tutorials/docprimer/kate-validate-xml.png | Bin 0 -> 70600 bytes doc/tutorials/docprimer/quanta-doc-primer.png | Bin 0 -> 27366 bytes .../docprimer/quanta-doc-structure.png | Bin 0 -> 12574 bytes doc/tutorials/docprimer/quanta-entities.png | Bin 0 -> 6899 bytes doc/tutorials/docprimer/quanta-tag.png | Bin 0 -> 60347 bytes doc/tutorials/docprimer/quanta-toolbars.png | Bin 0 -> 28434 bytes doc/tutorials/docprimer/quanta.png | Bin 0 -> 54149 bytes doc/tutorials/docprimer/xmlval.png | Bin 0 -> 455 bytes doc/tutorials/docprimer/xsltproc.png | Bin 0 -> 257 bytes doc/tutorials/markup/CMakeLists.txt | 9 + doc/tutorials/markup/Makefile.am | 3 + doc/tutorials/markup/index.docbook | 5317 +++++++++++++++++ doc/tutorials/styleguide/CMakeLists.txt | 9 + doc/tutorials/styleguide/Makefile.am | 3 + doc/tutorials/styleguide/index.docbook | 466 ++ tutorials/.directory | 105 + tutorials/CMakeLists.txt | 11 + tutorials/Makefile.am | 4 + tutorials/docprimer.desktop | 4 + tutorials/markup.desktop | 4 + tutorials/styleguide.desktop | 4 + 29 files changed, 8126 insertions(+), 1 deletion(-) create mode 100644 doc/tutorials/CMakeLists.txt create mode 100644 doc/tutorials/Makefile.am create mode 100644 doc/tutorials/docprimer/CMakeLists.txt create mode 100644 doc/tutorials/docprimer/Makefile.am create mode 100644 doc/tutorials/docprimer/index.docbook create mode 100644 doc/tutorials/docprimer/kate-plugin.png create mode 100644 doc/tutorials/docprimer/kate-validate-xml.png create mode 100644 doc/tutorials/docprimer/quanta-doc-primer.png create mode 100644 doc/tutorials/docprimer/quanta-doc-structure.png create mode 100644 doc/tutorials/docprimer/quanta-entities.png create mode 100644 doc/tutorials/docprimer/quanta-tag.png create mode 100644 doc/tutorials/docprimer/quanta-toolbars.png create mode 100644 doc/tutorials/docprimer/quanta.png create mode 100644 doc/tutorials/docprimer/xmlval.png create mode 100644 doc/tutorials/docprimer/xsltproc.png create mode 100644 doc/tutorials/markup/CMakeLists.txt create mode 100644 doc/tutorials/markup/Makefile.am create mode 100644 doc/tutorials/markup/index.docbook create mode 100644 doc/tutorials/styleguide/CMakeLists.txt create mode 100644 doc/tutorials/styleguide/Makefile.am create mode 100644 doc/tutorials/styleguide/index.docbook create mode 100644 tutorials/.directory create mode 100644 tutorials/CMakeLists.txt create mode 100644 tutorials/Makefile.am create mode 100644 tutorials/docprimer.desktop create mode 100644 tutorials/markup.desktop create mode 100644 tutorials/styleguide.desktop diff --git a/CMakeLists.txt b/CMakeLists.txt index dac8dc5..712575d 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -75,6 +75,7 @@ option( BUILD_KSIG "Build kde email signature manager" ${BUILD_A option( BUILD_NOATUN_PLUGINS "Build noatun plugins" ${BUILD_ALL} ) # need tdemultimedia option( BUILD_RENAMEDLG_PLUGINS "Build KRenameDlg plugins" ${BUILD_ALL} ) option( BUILD_TDEFILE_PLUGINS "Build additional tdefileplugins" ${BUILD_ALL} ) +option( BUILD_TUTORIALS "Build tutorial help handbooks" OFF ) ##### configure checks ########################## @@ -109,6 +110,7 @@ tde_conditional_add_subdirectory( BUILD_KSIG ksig ) tde_conditional_add_subdirectory( BUILD_NOATUN_PLUGINS noatun-plugins ) tde_conditional_add_subdirectory( BUILD_RENAMEDLG_PLUGINS renamedlgplugins) tde_conditional_add_subdirectory( BUILD_TDEFILE_PLUGINS tdefile-plugins) +tde_conditional_add_subdirectory( BUILD_TUTORIALS tutorials) ##### write configure files ##################### diff --git a/doc/Makefile.am b/doc/Makefile.am index 6812bd2..85c6cde 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -1,4 +1,3 @@ - KDE_LANG = en KDE_DOCS = AUTO SUBDIRS = $(AUTODIRS) diff --git a/doc/tutorials/CMakeLists.txt b/doc/tutorials/CMakeLists.txt new file mode 100644 index 0000000..6bc5f18 --- /dev/null +++ b/doc/tutorials/CMakeLists.txt @@ -0,0 +1,9 @@ +################################################# +# +# Improvements and feedback are welcome +# +# This file is released under GPL >= 2 +# +################################################# + +tde_auto_add_subdirectories() diff --git a/doc/tutorials/Makefile.am b/doc/tutorials/Makefile.am new file mode 100644 index 0000000..85c6cde --- /dev/null +++ b/doc/tutorials/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = en +KDE_DOCS = AUTO +SUBDIRS = $(AUTODIRS) + diff --git a/doc/tutorials/docprimer/CMakeLists.txt b/doc/tutorials/docprimer/CMakeLists.txt new file mode 100644 index 0000000..a4e5cd9 --- /dev/null +++ b/doc/tutorials/docprimer/CMakeLists.txt @@ -0,0 +1,9 @@ +################################################# +# +# Improvements and feedback are welcome +# +# This file is released under GPL >= 2 +# +################################################# + +tde_create_handbook( DESTINATION khelpcenter/docprimer ) diff --git a/doc/tutorials/docprimer/Makefile.am b/doc/tutorials/docprimer/Makefile.am new file mode 100644 index 0000000..4169155 --- /dev/null +++ b/doc/tutorials/docprimer/Makefile.am @@ -0,0 +1,3 @@ +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/tutorials/docprimer/index.docbook b/doc/tutorials/docprimer/index.docbook new file mode 100644 index 0000000..28792b1 --- /dev/null +++ b/doc/tutorials/docprimer/index.docbook @@ -0,0 +1,2160 @@ + +The &kde; Documentation Team'> + meinproc"> + checkXML"> + Subversion"> + + +]> + + + + +The &tde; Documentation Primer + + +&kde-authors; + +CarlosWoelz + +&tde-authors; + + + +2004 +The KDE Documentation Team + + +2004 +Carlos Woelz + + +&tde-copyright-date; +&tde-team; + + +&FDLNotice; + +&tde-release-date; +&tde-release-version; + + + +This document provides information to start writing documentation for &tde;. +Please report any errors or omissions to +trinity-devel@lists.pearsoncomputing.net. + + + + +TDE +Writing +Documentation + + + + + +Introduction + + +The objective of this guide is to present all information required to make the +experience of writing &tde; documentation as easy as possible. +The next chapter gives some information about what skills you'll need for the task. +It is important to note that this guide is a joint effort of the &tde; +English Documentation Team and the &tde; Quality Team. You can ask for support +from both teams at any time. + +The &tde; English Documentation Team exists to +provide end-user documentation for the whole of &tde;. It's a big task, but an +important one. Although &tde; aims to be easy to use, not everything is obvious +without some help, and, in a project this big, even an experienced user +can't know every corner of &tde;. +The team is made up of people doing several different tasks: + +Writing documentation for individual applications + +Writing wider documentation for the whole of &tde; (like +the User Guide, or this document). + +Proofreading and/or updating documentation to ensure +that it is correct and up-to-date. + + +Contributors to all of these areas are always welcome. You can +choose the area you would like to contribute to, based on your skills +and what you enjoy doing. If you need any help with documentation issues, +do not hesitate to ask at the &tde; Documentation mailing list, +kde-doc-english@kde.org, or on IRC in the channel #kde-docs on +irc.freenode.net. + + + +The &tde; Quality Team provides support for +new contributors, and to coordinates the efforts of the volunteers. +The &tde; Quality Team Website +provides guides to help you with some general development tasks, +such as getting the sources, +Building +&tde; From Source Step By Step, and + +Working with Subversion, &etc;. If these guides are not sufficient, and you +are having problems with &tde; development, we provide support for new contributors +at the &tde; Quality mailing list, kde-quality@kde.org, or on IRC +in the channel #kde-quality on +irc.freenode.net. + + + + + + +Getting Started + +If you got this far reading this document, you're probably interested in +helping with &tde; documentation. If so, welcome aboard! We're always +happy to have new contributors, and whatever your skills, you can help +make &tde; even better. + + + + +Things You'll Need + +To write documentation, there are only three things that are absolutely +necessary: some English knowledge, knowing what you want to document, and +access to a relatively recent version of the application you want to +document. + +Notice that the list of requirements does +not contain a requirement that you learn DocBook, +or any of the other tools we use. We're very happy to receive +documentation written in plain text. We would much rather have the +content and have to add formatting than have no content at all. + + + +English Knowledge + +All &tde; documentation is originally written in English, so you +have to be able to write English to a reasonable level. That said, you +don't need to be a native speaker, and you don't +need to write word-perfect English. There are native English-speaking +proofreaders on the documentation team, and we would much rather have +some documentation that needs a little tweaking, +than no documentation at all. If you don't feel comfortable writing in +English, you might like to contribute to one of the &tde; translation +teams. You can find more information about translation on http://i18n.kde.org. + +If you're a fluent English speaker with an eye for detail, you +might be interested in joining the proofreading +team. Just drop an email to kde-doc-english@kde.org if +you'd like to help the proofreaders. + + + + + +Deciding What to Write About +&tde; is a very large project, with many different parts and +programs. Because of this, it can be hard to know where to start if you +want to contribute. There are a few rules of thumb that can help you +decide what to write about: + +Find a topic that you'll enjoy writing about; It will +increase your motivation and help you to produce better documentation. + +Write about an application you know well. You'll be able +to spend more time on writing and less time trying to work out how the +application works. On the other hand, documenting an application can be +a good way to learn about how it works, especially if you like a challenge! + + + + + +If you are looking for an application to document, or just checking the status +of the application you want to work with, the + +&tde; Quality Team Wiki contains lists of applications, organized +by modules, and their general status, including documentation status, and who +is working on it. Not all modules and applications are included or up to date, +but it is certainly worth checking. + +If you start documenting one of the listed applications, please add your +name to the wiki pages as well. But If you just can't find an application to +work with, write to kde-doc-english@kde.org and ask for +suggestions. There's always something available to do, but there's no obligation +to work on a particular application. Also, contributing to a document doesn't +force you into keeping that document up-to-date (although if you can do that, +it's very welcome!). + + +Another place to check is the &tde; bug list at http://bugs.kde.org. This is usually +more detailed than the wiki, and provides a place to list specific small +changes that are needed to documents. These are often nice small jobs +to get you started contributing. A set of quick links to ready made +queries are available from the Documentation Project's +http://i18n.kde.org/doc/current.php page. + +It is also helpful to the team to file more bugs like these +above. You will need a bugzilla account, and a recent copy of &tde;. +Simply open an application, choose +Helpappname +Handbook. Then just read through the document, +following along in the application. &tde; applications are a moving +target to document, and sometimes the documentation has not yet caught +up with a change to the interface or behavior of an application. Feel +free to file bugs for any of these issues you find, in order of urgency: + + +Inaccurate information about how an application +worksFor instance, if you previously needed to save +changes to a file before they take effect in the &GUI;, and this now +happens automatically, text referring to manual saving should be +removed, or it will confuse readers. + + +GUI options or menu items (or sometimes, entire +dialogs)This often happens in configuration dialogs, when +new items are added, a new grouping of existing options may be +created. + +New Features that are available and are not yet +documented. + + + + + +Access to a Recent Version + +To make sure that the documentation you write is up-to-date, +you'll need to run a recent version of the application you are working with. +This normally means a recent beta version, a version of your application +compiled from sources or a version of &tde; compiled from sources in the &svn; +repository. If you think that compiling from sources is too burdensome, and you +cannot get some recent beta packages, there are still some interesting +possibilities to work around this requirement: + + + +Write about a stable application: there are many apps with a stable interface +which are still lacking good documentation. In this case, the last stable version +provided by your distribution will be sufficient to write about it, no +compiling required. + + + +Using a remote desktop connection to preview the development version is +an ideal solution to this problem. The FreeNX terminal server technology +enables decent desktop performance even with dial up Internet +connections. We are planning to offer this service to &tde; documenters, but +the infrastructure is not yet in place (as of May +2005). You may ask the kde-quality@kde.org mailing list +about it, if you think this is the way to go. + + + + + + +If you want to try out building &tde; from sources, the &tde; Quality +website provides +a detailed, +step by step building guide. You can find even more information at the +&tde; Developers Website. +If you face any problems in the +compiling process you can't solve by reading the building guide, don't hesitate +to as for help on kde-quality@kde.org. + + + + + + + +&tde; Writing Recommendations and Guidelines + +To maintain a uniform documentation set, there are some consistency rules +to be followed, that you should know before starting. In this chapter you will +find guidelines about targeting your audience, English usage, and what to cover +when you are documenting an application. + +We also offer some general writing tips to help you to +get started, provided by experienced &tde; documenters. + + +Writing for your Audience + +Since &tde; is used by people with a wide range of abilities, from +completely new users to long-time gurus, the documentation should be +appropriate to this audience. Therefore, in general, documentation +shouldn't assume too much about the knowledge of the reader, without +being patronizing. There are no hard-and-fast rules, but here are some +tips that should help: + +Remember that the audience varies with the application: for +example, a server control module has a very different user base than a user of a +game, and the manuals should reflect this. Don't insult the administrator +intelligence, and don't assume knowledge for the gamer that might not be +there. + + +Keep a logical progression of difficulty: Keep the first few pages +of the document simple, and accessible to users who have never seen the +application before. More technical information should appear towards the +end of the document. + + + +Remember also that different types of documentation have different +purposes: + + + +Application Handbooks + +These may go into great depths on the configuration, behavior and +sometimes the philosophy of an application. There is scope to cover +corner cases of configuration, commonly asked questions, and advanced +troubleshooting techniques. They should also always contain +a complete reference to all the available menu functions and +configuration options for the application (but while these are required, +they should be certainly be considered a minimum of information to +provide.) +The Application Handbook should be answering the question: +What are all the things I can do with this application? + + + +User Guide + +A much higher level overview of &tde; and its applications. This +aims to be the first stop for users to look for information, and should +be task based. +When writing for the User Guide, you should assume a working +default installation of &tde;, and you do not need to cover all cases of +unusual configurations, only the very common variations, nor should you +cover in-depth troubleshooting. You might provide answers to some very +common configuration errors (or not, as appropriate) and refer to the +Application Manual, the Application's Website, mailing list, and any +appropriate man pages for more detailed information. +Most people reading this guide do not have an actual problem, they +simply want to achieve a goal, and don't yet know how, or where to find +that information. +The User Guide should be answering the question: How do I +do this common task, ⪚ send an email, play a +movie?. + + + +What's This Help + +A very focused and specific type of assistance, about a single +configuration or interface item. Again you should not really attempt to +cover all cases here, only common ones, and explain what the option +does, not why it is there. Refer users to the Application Handbook if +appropriate, for more information. +Provide an example of the expected input, if that is not clear +from the context. +The What's This Help is most often answering the question: Do I +need to fill in this box? If so, what do I put in it? + + + + + + + + +English Usage Guidelines and Recommendations + +&tde; documentation is written in +standard US English (rather than any other regional variety of +English). We have a set of standard forms of certain words (such as +email instead of e-mail) to improve +consistency across all documentation. Work is underway to expand and +formalize this list, but for the moment, it is located at http://www.kde.me.uk/index.php?page=Consistency+rules. +There are also standard names for &tde; widgets, which are listed in + + +A good way to catch simple errors +is to read the text out loud, or have someone else read it to +you. Passages that don't flow easily or have obviously awkward construction +of the type you may miss on the screen, will usually become blindingly +obvious when you hear them. This is especially the case with detecting +really long sentences, as you will run out of breath and turn +blue. + +Some tips about writing readable sentences: + +Use complete sentences. Not fragments. Like these ones. + + +Avoid run-on sentences, sentences that cover several different +subjects, or sentences that could be broken up into several sentences; +avoid sentences that can fill a whole paragraph all by themselves and +that are really long, like this one, which is all of the above. + + + +Use a comma before and in compound sentences, ⪚ +Use the left mouse button to select and copy text, and the +middle mouse button to paste it. + + +Keep to logical sentence order. +For example, &konqueror; is a web browser with the +ability to browse file systems and it includes a javascript +interpreter. (Do you see why this is awkward?) + + +Try not to use the same word several times in the same sentence. +An exception to this, is an application command or technical word, +where this repetition is necessary, and improves clarity. + + +Do not start sentences with any of and, +so, but, because, or +however. + + +Try to avoid contractions, rather spell out both words; ⪚, +it is rather than it's; can +not rather than can't + + +There is no need to worry about simple text formatting such as +leaving two spaces after punctuation or indenting paragraphs. This is +all handled by DocBook &XML; and the XSLT +stylesheets in use. + + + + +Remember, we have also an active proofreading team, and there is +always someone to help you with grammar, so just +write and have fun! + + + + + +What to Include +For most applications, a structure something like this would be +appropriate: + + +Introduction: A basic description of what the application does and +any noteworthy features, &etc;. + + +Using KApp: Task-based description of +the most common uses of the application. + + +Program reference: Description of all of the features of the +application. This would usually include a menu reference, but might also +include command line options, syntax description, &etc;, if they are +appropriate to the application. +This is required for all &tde; applications that you at a minimum +cover any application specific menu entries, and strongly recommended +that you cover all the standard ones too (in case users are reading the +manual outside of &tde;, or yours happens to be the first one they read, +and it provides consistency. Cut and paste is your friend here.) +Note that although this is a required section, and for some +applications it is the only section, it should be considered a +minimum. + + +Frequently Asked Questions: List the most common questions and +problems that users have with the application, and their +solutions. How do I ...?-type questions are especially +appropriate. + + +Credits and License: A list of those who contributed to the +documentation, and a link to the &GNU; Free Documentation License, under +which all &tde; documentation is licensed. +This chapter is required for all &tde; documents, and must have +at least the two license links (one for the +document, and one for the application) + + +Installation: This chapter can be automatically generated, +provided that the application follows the usual &tde; compilation +procedure (&ie; ./configure, make && make +install). If you need to add extra information about compiling +or installing the application, it can go here. + + + + +You will find a template document with these sections in +trunk/KDE/kdelibs/kdoctools/template.docbook file in &tde; +&svn; repository. + + + + + +Writing Documentation: Procedures and Tools + +If you're worried about having to learn a lot of new tools and +procedures in order to write documentation, you don't need to, +because the information we've covered so far is everything you need to +know to be able to contribute. Although we do have +some tools we use and procedures we follow, it's not vital that everyone +knows them in detail, especially when starting out. + +For example, all +&tde; documentation is written in DocBook &XML;, but we're very happy to +receive documentation written in plain text. There are people on the +documentation team who are very familiar with DocBook, and can easily +add the markup if the content is there. + +Another example: if you are starting to document an application from +scratch, you don't need to get the sources of the current documentation. But +if you are starting from existing documentation, you don't need to know +about how to get the sources, there are other means to do that. + +Of course, if you want to learn about DocBook, you can. After a +little practice, you will probably find that it's not as hard as it +looks. And if you learn about dealing with a &svn; repository, you will +be able to integrate yourself to the regular &tde; development process +(upload your changes, work together with other developers, &etc;) + + + + +Getting the Documentation Sources + + +If you are starting your document from scratch, you probably do not +need to read this section, and may start working right now. + + + +You are welcome to use plain text to contribute to &tde; documentation. +It is a great way to start, and we strongly encourage it. +If you will miss the power of the DocBook format as +you improve your documentation skills, then you can learn it. In the mean +time, someone will manually edit the plain text to add the DocBook +markup and commit it to &tde; &svn; repository, removing the burden of doing most of the +more complex stuff covered in this very guide. We'll take a look at writing in +DocBook and using &svn; later in this document, so if you're interested, read on, +but if you want to use plain text, you can go directly to +. + + +Documentation for &tde;, like the rest of the source code, is kept +in a &svn; repository. &svn; provides a way for +many developers to work on the same source code (or in our case, the +same documentation), and has many useful features to help with this. For +example, previous versions of every file are saved so that any mistakes +can be quickly backed out, if they can't be easily corrected. + +The basic principle behind &svn; is simple: one server stores a +definitive copy of the files making up a project. This is known as the +repository. Each developer can download the files to make +their own private copy, named working copy or +sandbox. Using &svn;, the developers can upload their +modifications to the main repository (a process called "committing") +or update their own copy to reflect recent changes made by others. + + +There are two main ways edit the contents of a &tde; document you +want to improve: using plain text or DocBook. + + + +Working with plain text sources + + +The docs.kde.org +website displays most of the &tde; documentation in &HTML; format, updated +daily from the &svn; repository. There are two versions available in the website: the +stable version and the +&tde; from &svn; version. +You will always use the latest version of the documentation, &ie; the +&tde; from &svn; version. + + +The docs.kde.org +website presents a quick and easy method of retrieving +the latest version of the &tde; documentation. Clicking the name of the +application you want to document in the list will open the documentation in +your web browser. Simply copy the text from the website to your favorite +text editor, edit it , and submit the results in +plain text to the &tde; Documentation mailing list, +kde-doc-english@kde.org. Please note that not all &tde; +applications are listed there. If you cannot find the documentation of +the application you want to work with, then you can request it by sending a +message to the &tde; Documentation mailing list. + + + +Now you know everything you need to start working. When you are +finished writing, you may want to read . Have fun! + + + + + +Retrieving the DocBook sources + + +The latest DocBook sources are located inside the &tde; repository. +Now you need to find and retrieve them. + + +The software inside the &tde; repository is divided into +modules, which are used to organize the different +software projects inside the repository. Modules are the top-level folders in the +&svn; repository folder tree, and each one contains a group of related +applications. These modules are sometimes released in binary +form as packages. If you know the name of the package +your application belongs to, you probably know the module name as well, as +they are frequently the same. You need to know in which module your application +is, to retrieve its DocBook sources. For instance, &kmail; is in the +tdepim module, &quanta; in the tdewebdev module, &cervisia; in the tdesdk module +and so on. If you need any help in this process, don't hesitate to ask. Each +module contains a folder named "doc", and inside it, you can find the +DocBook sources. + + + +To access the repository, you can use the svn command line application or browse the &tde; WebSVN website (websvn.kde.org). + + +The websvn.kde.org is a +web +based representation of the contents of the &svn; repository. It is easy +to download files using websvn.kde.org, +the operating system or desktop you use does not matter. + + + +Retrieving your own working copy of the repository has many advantages. You +will be able to use your working copy to create files containing the changes you +made, to update your copy with changes made by other documenters, and if you get +a &tde; &svn; account, to upload your changes directly to the repository. +But this is out of the scope of this section. Here we will show you simply +how to retrieve the sources using &svn; the easiest way we can. +You can get more information about these tools (they are really useful) +by reading the . + + +Retrieving documentation sources using WebSVN + + +Go to http://websvn.kde.org +using your favorite web browser. Let's suppose you are looking for +&cervisia;'s documentation sources. + + + The &tde; repository is divided into trunk +(also known as HEAD, where development is going on, +branches, where both stable and working branches live, +and tags, where you can retrieve snapshots of sources at +a release. Most work for documentation goes on in trunk, +so click there. + +The main &tde; modules are in the TDE folder, +so click on that. + + + +Click the "trunk" link to get the main branch listing. Click on "TDE" +to get the list of modules from a &tde; release. + + + +&cervisia; is part of the tdesdk module (&tde; software +development kit module). Therefore, click the tdesdk item on the +list. The contents of the tdesdk module will be displayed. + + + Click the doc item on the list, to see the +contents of the documentation folder of the module. The contents of the +doc (documentation) folder will be displayed. + + +Select the application you want to work with from +the list (in our case, cervisia). All &cervisia;'s +documentation source files will be displayed, being images or DocBook files. + + + +Now you reached the list of files that are part of +&cervisia;'s documentation, including +images and DocBook sources. The DocBook sources are files in the format +*.docbook. In this case, there is only +one file file in this format: index.docbook. Click this +file on the list. A list of revisions (versions) +of that file will be displayed. + + + +Click the download link from the revision on the top of +the list. It is the most recent one. Save the file. Repeat this process +with all the files you want to download. + + + + +We use &kmail;'s documentation sources as example in the +following procedures. + + + +Retrieving documentation sources using &svn; + + +Check if you have the &svn; client installed (hint: enter svn in the +terminal screen). If not, install the &svn; package using the tools provided by +your distribution. + + + +Now it is time to download, or checkout the sources. +Using &svn;, type in the terminal: +mkdir path/to/working/folder +cd path/to/working/folder +svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/module/doc/application + +where path/to/working/folder is the folder you want +to install the sources in your system, trunk/KDE/module is the +application's module location in the repository and application is the +application name. Remember to use small caps to type the application and +module names. In our example, &kmail; is in the tdepim module, so you would +enter: +svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepim/doc/kmail + +Note that only applications which are part of a regular &tde; release are under +trunk/KDE/. Amarok docs, for instance, is in the +multimedia module of extragear. Extragear is contains mature applications which are +not part of a &tde; release. To get Amarok docs, type in the terminal: + +svn checkout svn://anonsvn.kde.org/home/kde/trunk/extragear/multimedia/doc/amarok + + + + + + + + + + +&quanta; + + +&quanta; is a friendly editor for SGML and &XML; +documents. &quanta; features syntax highlighting, autocompletion, autoclosing +and code folding for DocBook tags, easy access for the &tde; documentation +tools, &meinproc; and +&checkxml;. + + + +A screenshot of &quanta;'s main window + + +A screenshot of &quanta;'s main window +A screenshot of &quanta;'s main window + + + + +Some of the tools available for DocBook editing are the document +structure sidebar, tag editor sidebar and, starting with &quanta; 3.4 (which +is part of &tde; 3.4), &quanta; offers a DocBook toolbar, complete with table +and list wizards, ui elements, admonitions, &tde; tools and other standard +tags. While &quanta; offers a visual page editor for html and xhtml +pages, there is no support yet for DocBook visual editing. We highlight here +some of these features. + + + + + + + +DocBook Toolbars + + +The DocBook toobars offer easy access to the most common DocBook tags, +plus the list, table and image wizards. You can check your DocBook document +using the + +checkXML button from the +Tools toolbar: the output of the script will be displayed +in he Messages sidebar, in the bottom of &quanta;'s main +window. If there is no output, that usually means no errors. +To process the DocBook into html files, use the + + +meinproc button on the same toolbar. + + + +Depending on the version of some XML utilities used by &quanta;, the + + +checkXML and + +meinproc scripts +can present bugs. Starting from the upcoming &tde; 3.4.2 release, these bugs +will not exist anymore. But until there, if you experience these bugs, (in +special if &konqueror; is not starting up when using the +meinproc script or there is no output when using the +checkXML script, you can get and install the +updated docbook +scripts from kde-files.org to solve these issues. + + + +A screenshot of &quanta;'s DocBook toolbar + + +A screenshot of &quanta;'s DocBook toolbar +A screenshot of &quanta;'s DocBook toolbar + + + + + + + + + + +Tag Editor + + +The tag or attributes editor is located on the right sidebar, and it shows +the available attributes for the tag which is currently being edited. +The tag editor helps you to edit the attributes for the current tag: just click +on the Value column of any attribute to edit it. + + + +A screenshot of &quanta;'s attribute editor sidebar + + +A screenshot of &quanta;'s attribute editor sidebar +A screenshot of &quanta;'s attribute editor sidebar + + + + + + + + + +Documentation Sidebar + + +Another useful feature is the documentation sidebar, which allows you to +download and use documentation packages as offline reference. This guide is +also available offline, using &quanta;'s documentation +sidebar. Just grab and install the +&tde; Doc +Primer documentation package. The documentation sidebar is on the right +side of the main window. + + + +A screenshot of &quanta;'s documentation sidebar + + +A screenshot of &quanta;'s documentation sidebar +A screenshot of &quanta;'s documentation sidebar, showing the +&tde; Doc Primer + + + + + + + + +Entities Autocompletion + + +&quanta; offers autocompletion for entities. However, this feature is +hardly useful without the &tde; entities definitions. To generate the entities +list for the &tde;, follow the procedure below: + + + +The autocompletion feature still has some bugs in the 3.4.1 release. +These bugs are fixed, and will be available starting from the 3.4.2 release. + + + +Generating and installing the <filename>entities.tag</filename> file + + +Open &quanta;. Choose the DTD +Load & Convert DTD menu item. + + + +Now, we have to select the right dtd file to convert. +On the dialog, select the &tde; installation folder (usually +/usr or +/opt/trinity. If you cannot find it, type +$tde-config --prefix +on a terminal application. The dtd file we want is named +kdex.dtd under +share/apps/ksgmltools2/customization/dtd/. +Select it and press OK. A new Document Type Editing +Package (DTEP) for kdex will be created. + + + +Now that you have converted the dtd, you can either use it directly, +by choosing the DTD +Change the DTD... and selecting the +kdex dtd. But the best solution is to install the +entities.tag file for automatic use with the &tde; +docbook dtds. + + +Now, let's copy the file from the kdex dtep to the kde-docbook +dtep. You can use a console application or a file manager to perform this action. +These locations are under the TDEHOME +folder, the folder that contains your &tde; settings and application data, +usually, ~/.trinity. If you cannot find it, type +$tde-config --localprefix +on a terminal application. The dtep folder is under +TDEHOME/share/apps/quanta/dtep. +The simplest way to do copy it is using a terminal application (⪚ &konsole;). + + + +Start a console application and enter the command: +$cp `tde-config --localprefix`/share/apps/quanta/dtep/kdex/entities.tag `tde-config \ +--localprefix`/share/apps/quanta/dtep/kde-docbook-4.1.2/entities.tag + + +Restart &quanta;. + + + + + +A screenshot of &quanta;'s entities auto-completion feature + + +A screenshot of &quanta;'s entities auto-completion feature +A screenshot of &quanta;'s entities auto-completion feature + + + + + + + + +Document Structure + + +finally, the document structure displays the logical representation of your +document. By left mouse button clicking on an element, your cursor will taken +to the element's position in the document. By right mouse button clicking on an +element, you are presented with a number of actions that deal with navigating +and updating the tree. + + + +A screenshot of &quanta;'s document structure sidebar + + +A screenshot of &quanta;'s document structure sidebar +A screenshot of &quanta;'s document structure sidebar + + + + + + + + +&quanta; is part of the tdewebdev module, which is released as part +of &tde;. Binary packages are available for the majority of the +distributions. Quanta can be easily extended to support custom scripts, +toolbars and documentation sidebars. For more information, check the +application handbook. + + + + + +&kate; + + +&kate; is an extensible and powerful text editor which is part of the +tdebase module. &kate; can syntax highlight DocBook documents out of the box, +and is generally a very powerful editor, but you can get even more +XML specific functionality installing the XML plugin for &kate;. + + + +Installing the XML plugin for &kate; + + +The XML plugin for &kate; is available as part of the tdeaddons module, which +is released as part of &tde;. Binary packages are available for the majority of +the distributions. Install the binary package using your distribution tools or +compile tdeaddons to install the plugin. + + + +Open the Configure &kate; +dialog by choosing the +Settings +Configure &kate;... menu item. + + + +Select the Plugins item from the +Application tree. Check the &kate; XML +Completion and the &kate; XML Validation boxes. + + + +A screenshot of &kate;'s Plugin Manager Configure +Dialog + + +A screenshot of &kate;'s Plugin Manager Configure +Dialog +A screenshot of &kate;'s Plugin Manager Configure +Dialog + + + + + +Press OK. + + + + + +With the XML plugin for &kate; installed, you will have autocompletion, +autoclosing for DocBook tags and entities. Since &tde; documentation uses +entities widely, this is a very welcome feature. Additional XML tools will be +available trough the XML menu (in special, trough the +Validate XML menu item, which will allow you to +check your DocBook documents). The output of this action will appear in the +XML Checker Output button in the side bar located in +the lower part of &kate;'s main window. + + + +A screenshot of &kate;'s Main Window showing the XML Checker +Output + + +A screenshot of &kate;'s Main Window showing the XML Checker +Output +A screenshot of &kate;'s Main Window showing the XML Checker +Output + + + + + + + +Emacs and Psgml +The venerable &Emacs; editor has a powerful +SGML and &XML; editing mode called psgml. The price +of this power is a steeper learning curve than the other editors, so if +you haven't used &Emacs; before, you will probably want to try the other +editors first. If, on the other hand, you're already familiar with +&Emacs;, then psgml is your best choice. + +Installation of psgml is beyond the scope of this document, but it +should simply be a case of installing appropriate packages for your +distribution. The relevant configuration for &tde;-related documentation +is simple. Just tell psgml where the &tde; catalog files are located +with the following line in your .emacs file: + +(setq sgml-catalog-files + (list "CATALOG" "TDEDIR/share/apps/ksgmltools2/customization/catalog")) + +where you should replace TDEDIR with the path +to your &tde; installation. You might also want to use the following +line to instruct &Emacs; to use psgml to open all .docbook files: + +(setq auto-mode-alist + (cons '("\\.docbook$" . sgml-mode) auto-mode-alist)) + + + +There are of course plenty of other settings in psgml mode which +you can change to your taste: see the psgml info +documentation for more details. A sample .emacs +file, with some customizations useful for writing &tde; documentation, +can be found at http://people.fruitsalad.org/phil/kde/dot-emacs-psgml. + +Some basic keystrokes in psgml are: + + + + +&Ctrl;C +/ +End current element. This inserts an end tag for the +currently open element. + + + + +MetaTab + +Completes the current tag or entity, +context-sensitively. This will only complete on tags that are allowed at +the current point in the document. Note that, because indentation is +rarely used in &tde; documentation, it is generally safe to remap this +function to just the Tab key. + + + + + +&Ctrl;C +&Ctrl;F +&Ctrl;E + +Fold current element. This compresses the current +element so that only the starting tag appears. One use of this is to +fold all the chapter elements in a document, to get +an overview of the document on one screen, and make navigation around a +long document easier. You can unfold elements with the shortcut +&Ctrl;C +&Ctrl;U +&Ctrl;E +. + + + + + + +One particularly useful psgml feature that isn't well documented +is the sgml-parent-document variable. Setting this variable +appropriately tells psgml that this file is part of a larger +document. This enables the full range of psgml features for this file, +such as context-sensitive element completion. To use this feature, place +the following in a comment at the end of the child file (with the +arguments adjusted appropriately): + +Local Variables: +sgml-parent-document:("index.docbook" "book" "chapter") +End: + +The first argument is the name of the parent file (which will almost +always be index.docbook in &tde; +documentation). The second argument is the top-level (or +root) element of the whole document (&ie;, in the parent +file). The third argument is the top-level element in this file. + + + + + + +Checking and Viewing the Documents +There are a couple of &tde;-specific tools for manipulating +DocBook files, namely &meinproc; and +&checkxml;. &checkxml; (as the name +suggests) is used to check that documents are valid, well-formed +&XML;, and &meinproc; converts DocBook files to +&HTML;. Here's some hints on using each of them: + + +Using &checkxml; + +&checkxml; is a simple command with only one argument: the file to +check. However, the output can be a bit daunting, since one small +mistake can cause a cascade of errors. The trick is to look at the first +error, fix that error, save the file, and run &checkxml; again. Often, +fixing that one error will get rid of all the other error messages. When +running &meinproc;, the same procedure applies. + + +Most errors in DocBook sources fall into one of a few +categories. Here are descriptions of some of the most common errors and +their solutions: + + + + +Opening and ending tag mismatch + + + +index.docbook:880: parser error : Opening and ending tag mismatch: para +line 879 and sect2 +</sect2> + ^ + + + +This is possibly the most common type of error. It's +caused either by an element that hasn't been closed, or by tags that +overlap. The error above was generated by the following markup: + + + +... +878: running &meinproc;, the same procedure applies. +879: &checkxml; is a simple command with +880: +...]]> + + + + + +The para tag on line 879 has +not been closed before the sect2 on +line 880, causing the error. The simple fix in this case is to add a para before the closing sect2. + + + + +Element does not follow the DTD + + + + +index.docbook:932: element qandaentry: validity error : Element qandaentry content +does not follow the DTD, expecting (blockinfo? , revhistory? , question , answer*), got (answer) +</para></answer></qandaentry> + ^ + + + +This error is caused by an element in the document not matching +the requirements of the DocBook DTD (Document Type +Definition). The DTD specifies what each element must +contain. This list is shown after expecting in +the error message. This so-called content model is quite +difficult to understand at first: refer to the Duck Book and the section +Understanding Content Models for full information. + +The text after got shows the content +actually found in the document. + +In the example above, we have a qandaentry +which is missing the required question element. This +was generated by the following input: + + + +An answer + + +]]> + + + + +Adding a question element before the +answer fixes the problem. + +An easy mistake to make is to forget to put a +para element around text in, for example, a +listitem or a +sectn. This will be shown +as CDATA in the got +section of the error. + + + + + + + +Using &meinproc; + +The most common way to run &meinproc; is simply as + +&meinproc; docbook-file where + +docbook-file is usually +index.docbook. This command creates &HTML; pages +from the DocBook file. Note that these pages are only viewable in +&tde;-based browsers (like &konqueror;). If you need to view the &HTML; +output in another browser (for example, if you're placing it on line), +use + +&meinproc; stylesheet-name docbook-file + + +where +stylesheet-name is the +full path to one of the &XSL; stylesheets in $TDEDIR/share/apps/ksgmltools/customization. +To produce output suitable for the web, you can use +tde-web.xsl or +tde-chunk-online.xsl. See the +README file in that directory for more details. + + + + + + + + + +DocBook Introduction + +All &tde; documentation is produced in DocBook &XML; format, and +writers are encouraged to learn it (although it's by no means necessary, +and we're very happy to receive documentation written in plain +text). Although DocBook can look somewhat intimidating to beginners, the +markup is extremely self-descriptive, and many people find it easier +than &HTML; to learn. + +In this chapter, we'll just take a basic overview of the ideas +behind DocBook. For detailed information about individual tags and so +on, please see +The TDE DocBook Markup Guide. + + +Overview +DocBook is just an application of &XML;, so if you're familiar +with &XML;, then you'll feel right at home. If not, don't worry, as most +of the gory details aren't required knowledge for simply writing and +updating documentation. A DocBook file (and, indeed, any &XML; file) +consists of plain text, with tags surrounding some text to tell you (or +a computer) what that text represents. So, a snippet from a DocBook file +might look like: + + + + +paraTo display the clipboard history, click on the klipper icon + in the tde panel, or press keycombo +action="simul"CtrlAltkeycapVkeycapkeycombo. Previous +clipboard entries are shown + at the top of the pop-up menu which +appears.para + +The para and para show the start and end, respectively, of a +paragraph. These delimiting marks are called tags, and +the content they contain (along with the tags) is called an +element. The keycombo +tag has an extra piece of information specified: action="simul". This is called an +attribute, and makes the tag more specific. The words +surrounded by & and ; are entities. They're simply +variables that expand to some other text, and are widely used in &tde; +documentation. See for more +information about entities. Tags, entities, comments and other parts of +&XML; that aren't simple text are referred to as markup. + + + + +Content and Presentation + +One of the basic principles behind the use of DocBook in &tde; is +that content and presentation are strictly separated. DocBook files +contain the content, and &XSL; files contain the information about +presentation. This has a number of advantages, some of which are: + + +When writing, you don't have to worry about whether the +information is well presented, just that the information you're writing +is correct and readable. + + +All &tde; documentation has a similar look, so once readers are +familiar with conventions in one document, they're familiar with all documents. + + +Documentation is future-proofed, since by providing as much +information about content as possible, future formats, search engines, +&etc; are likely to be catered for easily. + + + + +In practice, this means that you should add markup that describes +what things are and not how they should appear. So, +in the example above, the keycombo (a +keyboard shortcut) tells the reader (or computer) that the keys &Ctrl;, +&Alt; and V should be pressed simultaneously, but +doesn't say anything about how that should be displayed in the final +output. (In fact, it appears as &Ctrl;&Alt;V, but it +could equally be converted to C-M-V à la &Emacs; +or even some other way of showing keyboard shortcuts. What's important +is that the DocBook source has the information +necessary to work out what is being referred to.) + + + + + + + +Structure + (<book> <chapter> <sectn> +<para>) + + + +&tde; Specialities +TDE-isms: entities, necessary bits (credits, translation + stuff) + + +Entities +Entities (which are simply variables which expand to some other +text) are an important part of DocBook markup, and are used particularly +widely in &tde; documentation. For example, there are entities defined +for almost all &tde; applications. Therefore, when referring to, for +example, &konqueror; in documentation, you should use: + +konqueror is, among other things, a +web browser. + + +This has several advantages. Firstly, it ensures that applications +are capitalized and marked-up consistently across all &tde; +documentation. This means that you don't have to remember whether the +help center program is KHelpCenter, KHelpcenter or Khelpcenter: the +entity (which is always entirely lowercase) automatically expands to the +correct one. + + + +There are entities defined for several classes of names: + + + +All &tde; applications + +As mentioned before, all &tde; +applications have an entity. The entity name is in entirely lowercase, +and expands to the correctly capitalized version of the application +name. There is also an entity for &tde; itself: tde. + + + + +Common English and technology abbreviations + +For example, &ie; is written as ie and ⪚ as eg. This ensures that the same markup and +capitalization are used for these abbreviations throughout &tde; +documentation. Technological abbreviations such as &HTTP; and &XML; also +have entities, which are capitalized as usual (&ie;, HTTP and XML for the previous examples). + + + + +Trademarks + +Names of companies and their products are often trademarked. For +this reason, it is important to mark them up with the +trademark tag, using the class="registered" attribute if +necessary. To reduce effort, and ensure that trademarks are given proper +acknowledgment, many common technology-related trademarks have been +given entities. For example, the entity X-Window expands to &X-Window;. + + + + +Contributor Names + +Names of contributors to &tde; documentation have entities of the +form Firstname.Lastname (or +Firstname.Initial.Lastname). Email +addresses of contributors have entities of the form Firstname.Lastname.mail. + + + + +Names of special keys + +Names of keys on the keyboard are always marked up with either +keycap or keysym. Since it can be +difficult to distinguish between these two tags, entities have been +created for common keys, ⪚, Ctrl +and Alt. + + + + + + +The definitions of these entities can be found in the following +locations in &tde; 3: + + + +Items not requiring translation (&tde; application names, +technology abbreviations, trademarks) + +tdelibs/kdoctools/customization/entities/general.entities + + + + +Contributor names and email addresses + +tdelibs/kdoctools/customization/entities/contributor.entities + + + + +Language-specific terms and key names + +tdelibs/kdoctools/customization/en/user.entities + + + + + + + + + +Necessary Sections +There are several sections that appear in all &tde; DocBook files, +even though they are not required by DocBook itself: + + + + +<!ENTITY package "tde-module"> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % English "INCLUDE"> + + +This appears in the prologue immediately after the +FPI. See prologue +for more details about this section. + + +<!-- TRANS:ROLES_OF_TRANSLATORS --> +This appears after the authorgroup element, and is a required +placeholder for use in translation (also known as i18n +from the number of letters between the first and the last of the word internationalization). + + + + + + + + + + + +Sending the New Documents and Changes to &tde; + +As part of the wider &tde; project, there are some things that +documentation writers need to be aware of. There are a large number of +other developers working on &tde;, and working together with all of them +is an important part of what we do. + + +Respecting the Release Schedule +String freezes, when we write, etc + + +This needs reviewing by someone who pays more attention to +releases than I do. + + + +The &tde; release process, in which we go from the fast-moving and +sometimes unstable world of the &tde; &svn; repository, to a stable, polished product, is never +exactly the same twice, but there are some common features: + +A schedule for the next release of &tde; is published at developer.kde.org, with the +definitive guide to what will be happening and when. There will be two +or more freezes, when changes of a certain type are not +allowed in the &tde; &svn; repository: + + +Feature Freeze + +When feature freeze is active, developers are not allowed to +commit new features to the repository. This is a good time to start writing, since +the features available in the application during this period are the +same as the ones which will be available in the released version. + + + + +String Freeze + +Text strings appearing in the &tde; user interface and in the +documentation are not allowed to be changed. This is to allow +translators to provide thorough translations which will match the +release. We are still considering how to work during this period of +freeze. One method which we have tried is to continue writing, but hold +back all changes to be committed in one go, immediately before the +release. + + + + + + + +Managing the Sources with &svn; + +You can find detailed information about how to use &svn; in conjunction +with &tde; in the +Managing &tde; Sources with Subversion guide + + + + + + +Working With Other Documenters and Developers + +One important and fun part of working on &tde; is the community of +other developers who you work with. The people you'll work with most +often as a documentation writer are the documentation team, the quality +team (if you're a new contributor) and the maintainer of the application +that you're working on. + +The documentation team is your main resource for help with doc +writing and a central point of contact to ensure that everyone's work is +co-ordinated. The main ways to contact the documentation team are via +the kde-doc-english@kde.org mailing list and on +IRC in the fkde-docs channel on the server +irc.freenode.net. If you +plan to work on a particular application, please tell us, so that we can +ensure that no-one else is working on it simultaneously, so that effort +would be duplicated. Also, feel free to contact us with any problems or +questions you might have about writing documentation. You don't need to +feel like you're working entirely on your own – there are plenty +of people who are able to help. + +The &tde; Quality Team provides more broad support. If you have +any general questions about &tde; development, or how documentation fits +into the wider &tde; environment, the Quality Team mailing list is a +good place to ask: kde-quality@kde.org. If you're not +sure whether to ask a question on the kde-quality or kde-doc-english +list, just pick one and ask. Many people who read one list read the +other, and you'll be pointed to the appropriate list if +necessary. + +Working with programmers is a little less formal. The usual reason +to contact a programmer is to ask about a feature or behavior of an +application that you're documenting. To find the appropriate person to +contact for a particular application, look in the +Help About +KApp menu item for +the maintainer. If you can't find a maintainer, ask on +kde-doc-english@kde.org or +kde-devel@kde.org. If asking on the kde-devel list, +mention that you're writing the documentation for that application +– it helps to identify you to those reading a busy list. In +general, programmers and other developers are happy to help, and willing +to work with you, so don't feel afraid of asking them for information, +and building up a working relationship. + + + + +Updating Documentation + +With the pace of change of &tde; applications, documentation can +rapidly become out-of-sync with the application it is describing. To +keep its value, documentation needs to be updated. Often this is simply +a case of reading the existing documentation, and checking each +description of an item against the latest version of the +application. For example, are there new items in the menus that are not +described in the documentation? + +Sometimes, more extensive updates are needed. If new features of +the application significantly change the way it works, then new sections +of the documentation may be needed, or reorganization of the existing +content might be necessary. In particularly severe cases, an entire +rewrite might be necessary. + + + + +Licenses for &tde; Documentation + +&tde; uses the FDL (Free Documentation License) for +all documentation. This license has several variants, some of which place +restrictions on how content is used in other contexts. + +The specific terms we use are: + +Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.1 +or any later version published by the Free Software Foundation; with no +Invariant Sections, with no Front-Cover Texts, and with no Back-Cover +Texts. + +This is the only version of the license that is safe to use for +documentation that is to be distributed with &tde;. + +The items that may differ in other uses of the FDL +are as follows: + + + +with no Invariant Sections + +Invariant sections are, as you might expect, sections that +must not be altered in any reproduction of the content. +The reasoning behind this, is so nobody can make a subjective claim, and +attribute it to you, by altering your words. + +For instance, if you say Foo is a terrible piece of +software and the section is marked invariant, the developers of +Foo can not take your writing, change it to say Foo is +a great piece of software and still attribute that opinion to +you. + +For many people, this restriction is incompatible with the +GPL and therefore some distributions choose not to +include any user manuals that contain Invariant Sections. +Since they must be reproduced verbatim, this also means we are not able +to reuse such content in our own manuals, without including this +statement. + +For this reason, Invariant Sections are not permitted +in documentation that is to be distributed with &tde;, nor can we safely +reuse content from other sources, if they include Invariant Sections. + +It is not normally appropriate to write opinion pieces in &tde; +documentation. Such content should be restricted to your own website, or +documentation that is not distributed with &tde;, so the fact we outlaw +Invariant Sections in &tde; documentation is not normally a +problem. If you think you have a special case, please raise it with the +documentation team, and understand that including such sections may prevent +some distributions adding your manual (or the software itself) to their +distribution. + + + + +with Front-Cover Texts names of +sectionswith Back-Cover Texts names +of sections + +As with Invariant Sections, these are texts that may +not be altered, and must be included in any reuse of any of the content. It +also means we would have to alter our license to match that of the content +we have reused. This leads to similar problems as that of the +Invariant Sections. + +This one mainly comes up if we want to use FDL +content found from other sources (for instance, books or websites.) In +these cases, the best approach is to ask the authors to permit relicensing, +and offer to include their front/back cover texts anyway, but without having +to change our license terms. + + + + + +The terms of the FDL as used by &tde; +documentation, are entirely GPL compatible, and do +not restrict the reuse of the content. Any deviation from these terms, +or any change in license could restrict distribution of your software or +documentation, and should only be undertaken with full knowledge of the +consequences, and with written permission of all copyright +holders. + + + + + +Using bugs.kde.org +Note how we use b.k.o (general to-do items). Also point to Carlos' +guide on quality.k.o + +The &tde; bug tracking system, located at http://bugs.kde.org, is now part of +the documentation team's toolkit. Issues with the &tde; documentation +can be filed in the docs +product of the bug tracker. Incorrect or outdated content, missing +content, outdated screenshots and typos are all appropriate reasons to +file bugs. + +When filing bugs, especially for incorrect or outdated content, be +specific about what's wrong. For example, if a certain page of a +configuration dialog is incorrectly documented, say which page it is in +the bug report. That way, someone fixing the bug can quickly find the +appropriate part of the application and the documentation, and make the +necessary changes with a minimum of effort. + +For more information on using the &tde; bug tracking system, see +http://quality.kde.org/develop/howto/howtobugs.php. + + + + + + +Leveraging your Newly Acquired Knowledge + + After finishing documenting an application, +you can leverage the knowledge you gained in the process and improve +the application's level of quality in other areas. The Quality Team provide +guides on how to perform many of these tasks. + + + +Writing context help and configuration descriptions: the handbook +is not the only source of help available for &tde; applications. Context help, +or whatsthis provides invaluable support for users, and +you will find it easy to write, especially after writing the handbook. +Documenting configuration options available through the KConfig framework may +require additional research, but configuration descriptions are often the only +documentation available for configuration options. + + + + +Performing usability analysis and tests: to document your applications, +you probably tested most of the application functionality in a systematic way. +Please take the time read the guide and report the usability issues and +suggestions that appeared in the process. + + +Writing guides and articles about the application: promotion is the key +for a successful open source project, as widespread use means +usually more probability of attracting prospect contributors, developers, +documenters, translators, &etc;. + + + + + + + +Credits and License + + +&underFDL; + + + +Widget Names +Steal from (and extend) the Visual Guide to +&tde;. + + + + + + +&documentation.index; + + + diff --git a/doc/tutorials/docprimer/kate-plugin.png b/doc/tutorials/docprimer/kate-plugin.png new file mode 100644 index 0000000000000000000000000000000000000000..8633ffe25e1c52a91a044227ffb7eef959c112b8 GIT binary patch literal 81275 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 G-2WfM%8Q5q literal 0 HcmV?d00001 diff --git a/doc/tutorials/docprimer/kate-validate-xml.png b/doc/tutorials/docprimer/kate-validate-xml.png new file mode 100644 index 0000000000000000000000000000000000000000..5d4e17b9bf5f82fcdb01f0fdfa295c54df200418 GIT binary patch literal 70600 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

4GU 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 literal 0 HcmV?d00001 diff --git a/doc/tutorials/docprimer/quanta-doc-primer.png b/doc/tutorials/docprimer/quanta-doc-primer.png new file mode 100644 index 0000000000000000000000000000000000000000..b30f874336adf4744e5bb55ff8a6cb4c5028cfae GIT binary patch literal 27366 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 literal 0 HcmV?d00001 diff --git a/doc/tutorials/docprimer/quanta-doc-structure.png b/doc/tutorials/docprimer/quanta-doc-structure.png new file mode 100644 index 0000000000000000000000000000000000000000..c8bd3bb28a603d159dee981270c83fa55475cc60 GIT binary patch literal 12574 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 literal 0 HcmV?d00001 diff --git a/doc/tutorials/docprimer/quanta-entities.png b/doc/tutorials/docprimer/quanta-entities.png new file mode 100644 index 0000000000000000000000000000000000000000..dc2a4a9df7ab670ba4817f21009bbc85ea32cef0 GIT binary patch literal 6899 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�> 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�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 L)Sp*@-v|E>3|6U> literal 0 HcmV?d00001 diff --git a/doc/tutorials/docprimer/quanta-toolbars.png b/doc/tutorials/docprimer/quanta-toolbars.png new file mode 100644 index 0000000000000000000000000000000000000000..d34a7594e0fbd508cb2630643ef04605902e678e GIT binary patch literal 28434 zcmZU51yEJ%7w=INkPr~0yStPwB}BSI1SADf>6TKur9m15q(hMI1|RCS=&11Z{Bhn80zr+C zlYXe_nzE7V;z2%Ed*uDupnmPA)>ch#=7bMVSA6(22bQu z$8L)CBMp&~T$ovZkLj1_!-G0g9zY1?+voFm$73abSo{@jxqfuGgX-hFc_>IA54_#HF>zzIsNkke@T)9ZY?dX zjlJdm;jyteYXf)}^3AAX!h4pm*1BS-Gf6I)QbkEM$@c5R19r4|_zHqRhljh$$~GZ^WOh_Uu{Yk008V z)z!Yn#G0C#p9+W(>`%X7^~ZBaNlEz@2@ZT04UAuOSQ!42VUX*&jtxVuwFM@ohx}wqGk83u$N&g~2Y?CgaHW z`}FA(0&&Cl;S=7q^>rZ>Zepy3w`i2O;amb@G=(~)gi0D)yVA>r;iPasL{)t>dMAYs zc}J89YU}bdU0BT-Bq29II6Csv~(q+_*rvW;l3tv zByQm|e$-@?p-i#M8MdTVj*X3NS=on~k<1>>C@RA8YNom!h{BnG`St-~b8{2!>j5{h zw6in+*XQ>{DI?e9*A7n;jnlkNUm)gDZzGy74@+wo*|dug+}x3*;Q^uDkx~o0-upDD zDcnjz-M3!;C?cWONFKU1}&s-DtVY zG^)hz8U6PI-%I-b=+gAql3>5^Tr%!5_LKMgB*l$8gEAuN@=xf)G*e~jDUZh+^v1(u zId2$~#b(RipY#~5dt}o4D_uv=V)x)h`M|DIXdIWMq2a7gjg{oVFNq$MmW!h~i45-` zEdljqmb~UW^>Z=`kip4k-}{macTj!gVi>O>ghfPZw>=&&78e$x;97q=M}4BB zLxdOUZJhY+`M@6ycaMwH!U9$=-z8j_*+7oLM~2<*Zh`R zv~uN3!{T+u4-J;%>g;0bPT@UKnVJ$_my4StCWkI2^I26fn(8__-6Yy=UiY*O9v|kF zpT4m--0+eeP{@&$qflGXe{r9*vZ|_eaks^)YT;L_uWhY<&$n-#QFO8y!U)0A3lh}7tp(q8w=$Y^LqL#K}SZW(}#B@kVxSyGmx_F^l%+5Wo4Xd znCpqL>DaSM`*^Eo^8GX<70A`OMK|{Q4&;K7efK`}cPh6}+&MmzI_?^77CK zLvOC6INaWFe$z3cl!fjT<2!5_8yB(Di;ZrhV0@ocMns<4LoGO`bg8Dyl&ZuBtL&HM$wi#QLb+gk zo_3?J$3*ThcF3+e(a9QCR=odCH~g~0^1exD$X(avIGr+hckh=w3Xfb|((z1uX@CD}zgvD?VOx_TvHFZqGLZ_SZS)NtQFYxr~UGa?@^FYx3c} za+6LBM`vdf*m8I)x7tL5<7!ic=~KCfx%Bj`0^_oiN5i$`rWJD7FUjL|UmFexWf}(S z3k)xGYKTkL1{>0qHtb&XU_a(a8f=# z>t#ysD9|cYefkuW`a5?>UgLXbW+pNDy%j#)0b@l6|8fizuu0X;JK;Y`8$c5pt%$&=5IG>@3lTqVmJTo2 zcoh{DHIZclSu|rf%qL2?FGJP$Vhz{Jz1V6WJ)U%ScD6?)tQGG#Ew|*o^MY!4FO&Y8 z5vzjB5s>{x}@`Q5%l)DCgwQZ|EJ{hR?Px zMoJ9Cp-3p%D@TaVyXDy3Iv1kAYJVIrA;Ez_F&ysT;_^z`KMd7+R+VAYoGhi#b{X!uRWIgpnj2B z#-%RFyQR=pfk0iOQb~;t%y*p%jXq%R4a_enFiGHg77@dwa$7KeWYxBd#KOmz7;5H? z>(^@ZIVU!qW8>mzn3&K!Jw1ok4=rtMWWBwctwO~9PMFRd$x?Z0IybZj;$&xKT_+4> zSmU|e9vD!DwQX-Khh|=`TVo6DwY9>$pLPI`B91&E8^;Gd)$c_|2pf~l@E%<*m7Em& zx9I5TPb(dcD)c3~hBXOOTu`U@gq#1oQk{a{w^ERsjsp|;n}3_mR9TT#-_xqg?9X!6M!1d zNW!nyQF51hBWkf6(PPS=<@$rO{QLwGJt!D&b-VctB+D*!(H#7?g0bJpQ(=##2 zI+4gb;jLvHxaPiJJ?&*kI_X*BmCvzW3|bcl5~Oi=hAaVHwWRnyi0+u7+o&ulDaXKB4oK{C71?X{W`4 zjEo0+E_J>4FTQg~-2Hej(zn(F?ems=Z{>P)wAbh>6samPbM>Y>V+=8SS*R%5n0*g* z(Hk2Z3z+e7OzuVpiQl|=vtU`4or7;gCt0yzy!A0-eEQU;5NXo;aZQ@M!C)Jpu8s7*t?E>gCWjPB9$Xr}uG35`2{mDCEDu+iH>AyS>+L>1ZNhC5m%3PxL$!*3 zmK!JbnrselJyTBk3B!8pOYSj^0!Jka60F?Q$9|cyTzqRRtL^VhR(hGV9``O$(amY( zr%%`hC3*-gf57RwWu4QkW@_5dZC?JHUS1OJIGY!nhL4$m)fhMHyL2F7e^x1d z@EFzpG`&VlXO}hBip@~*`TfT$@tm0Yawi|9RGJi74C2-}!Z07)FVe`QJZk9yRb%7++1DOA>`oqhC!MUsld%Kl6X0fKc zr3tPiMVsbjYpLk@HAIgb_&aEG+TXS84^oymTax#dJv?F?pnlq>PWACVl zJYIRPl1o#4o+TC=l!M3BOFAGI+d5^4S~!~&mYAogJeli+KddPcoVVDUuBj**Zcrqd z9lp&-mQSOc)1JP1&|(&S#1v(0I*;$oxTNrnpLar)P9jN_G5A0ypI&b+an(IEs&`ze zU`uFtEymmMRU$XVktEIV>1?cfiQmomBAPtcE~{*R6^33`Du&0s39Mwb%ke=p)Y{_m zoXqnn*DiM*@oZ}4;v}v-3Z`ME{BSv%<)P{Il^IcumX-2W>wShrA#b*!sJ{+}QGN%_B*in?ENn@T(k8fBh55nMkCdo!Im z3H5ahfu!Q#7&J5Ea$WUIOqq8dK9HK3o98^m#$d?KxWH!^$#@-oy~FiFsUh5KBv&b< z?V0PmKLGiV<&QDnk_EE!^KS{K-UdbtFY$DnmLuKnb1w-fqaNZ^gdBSJ=?znU0;C0P z0s1+hT4-a(9^&x*A4g&My5&NR>od2#(v&Xjgh3}8(NSDIOPa88adwpb>C9LRmGkBjhT(D9bjU1*TwYQWx(ci^&-4kA%8~tal(ux z{W{~Lsm$rkuF4l9ca%$Wa%A>Al$5YbY8FELmOD%Ub^lpi4Hnea)eWk3SYb5yYx|Z| z`#ZU?Bf5z5hEMxXUdTHLk0>h0cicIck5cIog&46U|l{n~Zi0ThjOYq6lJ>TV39 z(se`_C`^MASEA6V?CtGsw;PY-yM9)_z`so{h+Dk@)Jic`*r{dLh#NiLytRVe-QB&V zf}J=Z_^Gmk!@US{q3gg?LB)c3ewckr6CocHPs#tO%B#lCXG}-a2L~! zmtiKj-d}-^>WlEn*T^%0dlI}l-;Xg=b*`sC-Udh#UI*D!t!BKPaS^RXKI7~DgDZ>T zl3a?wU6~0MnqpMoYoAZXn3Yy zl@>O8`d}au(w3Iu0O+?BPOaH)Izx5E0tgvU^>WKPoA1qn@&5g$|}s2`wCLLsTt z;|K{2y@sfF-fYW~38nr1q~4hW7PRf0=TR>ysiuN;-CpvmQSu0yN0IIGL4vb0Ghq*? zeTK7Tnb<+ego1O!w>2m{d5pJA{A3AV@x%RF7O75zKZ>6Qp6stIj^=A*8N*ic@HiaP zsX5>4H?Gp#jr2Z8(J^#0ZxhCH;dKg9{X@Lt-iU`Ir&mk}w=O0oCTO>CW8Ax7{-2+F z-mksdrLp%ApYu8P*uFa~cT3`Iau9*IIvsCbI4zwj%NQ!ok3W3Pn?xJN7GP||O^j4@ z4eFgUK@`c!$tmc$?o(32>2Z0olF0v>)a!has(so1Vd=P3;n>2T;q0vT$M$;Q`F zsjzqcY;UhbP)K-@TUV12893to-JA|QKR@?d#zi@dR^WX5(;DcT#BB=USlhY>$Bg_h zf3PFw4Dgkdl+@bMu3sY{BFfIlK%n7JYRaHVLb<*?8T2-RQd{%;!%I!2rx>6KBgZZ$ z=O#P`vSz_zFsjm1gE9R)C{6}CQbYl7%oyXC-!^i3EML5MJH7eH+L}{fX0U=C0}~Ue zIiwGw1sLOEp=#M-y+5P661ZwY_j$v;61W(6m(*3=W2Y6Z!bu}qn_Y_SH-*3xYo(ap zj-N|CGNt3|JnjdU z`_$BLZXD3IN}5is8g|++K_^xfonuSO%&`oJn;3b}@M)fJ&%Lo?Ie(tz&FO01?&tIi zEO;uQxGI)(Prv7OV6mwWc%UeeBGEg$p~Kj$>1vt4-a2URYvry=t6e2s_5|?=34zzcLlc^aRrXAcm072aQbR>OfVj>8+x9ZkQ+Iynt=-M_WKchXZ zw(ev~_jo6=RYUiimY9M5J0k#zn=~dBWFuPRW5?dv4_V&t>Fa9~T1jaS?~Imo5Ke_PnqaOU7azYc^|ExCaU5?k3-)63 z)y1~mZYNQ8K|#p6;4x@#`d%l?u17yz>_FwqYG}~^aw(6UsT&Zd*L63^_HkI@O-w?t z1K5AZ@Xx*c_|ZYDUE|B^Y5t{^6?hQ)N3x>2#Xo{-t=q1k`3t8;)VC}q*{s+KLIube zS*_vyVO0gCojVEI5!Q?cDR1-3jvzd|*%o{zWm|{2r2!rdDQnS>3MJ&xV-knJiB}!l ztgB52)5PF`62;!|E2j$kb3FZGw7bw*&_fgBV!%lRl@neA!s|uX3NaU-DE)D+uf4QB zJy^|(DVUy`qV*CG5I{jEGyV4M+r(!Jm6;JnM8=mdgs_b}567QHf|QU^Q$y^1+)mX} z@#?$b=O0i_SJK|x-v9lr-8{jdt4hTTmVs6UPp7JUE5!Vlw)B-Mt1;Fhy($dAEL2{{#(hg&Qgusx3?vu$yZXpUfBt#C zVShjha2paXy)3CkMfIi0JUA)58JwWIIp)WipzuTL4vFxM7Pn&9-xjKu7u(*E{Vi73 z)?Er*jea=_30W}c+J$!!ww-r%i~u?qJt2ho)JU;rPeS^Mj7lH;zI@?tI9)3Qgm44# zugGL_e!R=f&c3vOR31U7a$U_y*eQH=A%9nF)H23?>*h0$UH=6~{}(Qfju{ONPLNQt}=m|s%>e}Z1;f-6<5oSgA|3$f+x?>t7GTLt*}LH(r!6e0s}2Ae5!*m7uY zE)qujiGXEOlxdZo-OjIv`X0NTJV(v2#k=ROE?ovZFT2QWj6gn4X|?O;sD9iP`6JQq zjYq26?i=%DZRydgMqLctVsZH#~cDJHTJKmR1zQQx4%SkJg76S|8J((3P zo2CgKhX2lr#1%<`finrCVj==D!%6_fa=w)|KnsWrpv<4v-GEaBRYJc#Z+~`ms-q8> zh-Z0f)0wjr`YJpvq9%A2RzHl2UU7VK{ev)(Hh^inP)>Pr*{hb3^WWvGcM;RS+y=dq z$Gnd~F_|A5`r|}}Ii_{pYOdeWBHeiX`1*2Mi~pzc4?~;IZ2Y#t`g>G}0g-LdPE>8s zgVWr8lcae5orL|AVk}bw&1V;W>0|yxAJ|)nV_3k*YRB4G;kY9BtrJ|{I917j?SO5MDx5#{S#twDHemJR`OX^-a)!x-R}>7SRqAKdp`sfz>a(b&M@AgKHO&uG|JoBDPM% zQ=AH9!z}mA9@dYTTn)Iea-`hcgkXm$rwG37=V~Sg*cjqk5P~|_|9x^Y7`Rr){UX>V z;Jwj&O%}j0?FxGcRRP$~{God*H_@ouYkpLxzyvvKm+lOd)$I?6 zEY5!M$C=xq$I&;Tulq2xxZANTMsJVu76H4Uog(3-5tK0F!?iJDJ}UyBw^EUQQ1^cU z?*=xNDB;~?BIe(4@;ezxJHV{7g^hn(@R`1T*tYl8nQn#IEpVd4Ur&FLIT!=<3Pi53 zpi7H4pcsELIkKgB@cm^1@jg6a^7n@gKRmc%rXrBspIpfP1~~k9IA-T>J`S$5zePcV z8t}_jum&v#MiJ_9cWmns_bu#P%elCZB;g;62@lRLW;D32q^wJzeJ*x|`+^j3ezHG2 zGlK<<;PZem=Fgu$E2>R@xhO-V!FB(eK<(IzbI;u4Go{Umaunna#lXNA8XEEey&$I7 z4+ZUZMr|z#pnq+}+F?=+3kxPNT59Joi8!SV3@CuwqWWDdgmT$J!>||d0kfzwLNQFj!_po5ssa6>$|TqoOkClbrhPd8lgv9T6iB=Sd75Fd9IZ z?*al)Aw@wgAwdOHH0*`GmZoM#X6CiHxHy0|`ebzPYwyAKC*wUk7*WAb%eyzT)JHRW znGcMQ%JTpZFje60VmHX(NV6Hr2vM$L(mPy>^KnZWRi)$ciA&cmxh2N&rm@3@LuT3Ja#X{gkD-NAWemd@QqX4CK% z48g3dEXk-6Nzet}byL1ku zCyq4WF0R|){p4>zcYFH#7f&x>oPAqcia(W>mUaX1i&-Exn%uFHn*WO>>3MQ-d+sxX zY{^i+G#2}w*pFSy7dfx1sNFs=+-xho0c{!_j)T8{vjDX|dGbVXG3*|~FVI>1Y~x-S zxzHV0usqllUQ&}FazNSj;W6#X`1C30jXb@8Q$=1k1W2G6sOsnhsxmhmsVOL6B71+{ zNbuEh2v9IZ-J5JzEvsRwG;>HGp!9i;Iy=XKRbHOa+gsc`g!uFYTCS zFZvu>&e1N?mxXY|%o+(x4{Ay<=R+!M`{k@kZ~OY6$NkSP-?{Do&aAH|dvmlU^Wp`| zN)^a)%q%Re0oY_vF_EAC#5ypUuT&iwf?CLwzZAUwMtPb}=D>^(sG zDhJ%8?>H=@wxY+dMojG%_C*Xu;&qcEgEFGF@TRF-Ij;%KXY_JC&dFjv)N~~ILr8z+ zV&>%R3Ky6KDayQ9a6zXBu38So+|kJ?6MzY0Oz@k9m#<&@gF4f{{O;Rx-*3;QAQy6a zdRmiego%lXY*BwFExKdL`fC7ZCGx$DU&5YUKYUb^+YEd?(cbi-sN4fr6Ly}WpeVY( z7$}+Jk9*BL`9#f^HC~@87?(va?Y@-lNnm)?;|$ zP33*gb9s;_VGM=5Vp$exc~<{)CYyC##0GX4Kt?j3(2opL`8B?T3BVCMcyA)qONpUr z>gbz}ytUyUKLU_t5EMcaoIWT~uV!kZ&a6LAB5!r+_wU=>l?$D(_yKeVyO%yb1-%3I z;-9s(11 zc&R}>VJIPoq`5hR&-TnXR=ZJq0QNCdS^%(`u?Y#LM_WH9%8XF}pb{M2o@rMqA&>p5 za(H+sxc~K@nx?PMZ~(zX(DoOCkX_dYkm;X8cW^X4_IjBTMO>^U$+Gv( zB<5p;sphR9O4g&4r%D@I)D?#xNo;Bco5v{XyT4Kf zGte4>0EZyvU)-&C+3o_D|7+vaQiRA>&{M!c+fyK4MnKv~Ez%6o2FR|v5Ps-xOi0pW z(;fS(8=Paxo5XD~K(48!HNV?Ug+$x}UnT699s>}HO#Yz`9UeS*6JV2oi|ueQ_u7>~ zEc#PMEm7jzY9Z~4aFT9P0Zf-tP z4!R>bK$ky%{vdNXKqW&!xrFQwD0h(hNrC>3RFxKHkAe?0&TI3A+k%T331%&qdp<+e z;9p|6;7xkenm~r(f9J#cJ^F z@bZ*X-}Rcc<)wRts4{nKvfFSI+iq5k_mwc2pa;9<_weL9_<@UZ_rV7pOpN(KBI>yD zsi{7<>c_IFF)_Z`vXOmzhKOIYHqJ{uc%tV!?UpZJLZet@=@UsqQ%XI1oQ@5BRu?Mw{UBtdNR8846J@gp1% zZ#o=u;`74vd+fv6D&BC2!@v6ikMS-z%x2 zZg;9@>@h)6jRGnQWwm27;ryW<^Wq%I92pRAXcI51l^9i6=6Dx}hY$9Czrvl92{snTQ0fTcSa z{$|bDF~*5OO7Z^o_&H%N9)cwM;ll^o+*^3Hfww8zNGwuXm5zX~yGoP1w*{mQ z3>RufMD3=^BWv0ZMMv~ew_VYq(yq`rn4z%BNLS`Vm2r|g3%Tru)P!z z|4-hf^^;mQh|8GS!^GuiDv-7U7qL2&XScG9yM(BeQaJwx^r|FUbLotQkFw~5LfBms71+bms6jWBaBgORt8cNMcpcj zGR>$rRsp|$Dk!*)J4@YbK#_yA#5crkTdd|wrNgH zj@g6C^$W-Q7zMaE;}hN!c7r<2AN^@#@oWj2z2SM@yrkjaE4DtdNWJOX>ht}(x^A(y z<$Y3pu+l*51Mds=`vbszT@W?|jK2t($!@<}__T&c^a;A{S!NMNm1BNO^Y_x`-G$ya zNh)&II^(yRl>dTRX$6Hl6xttD2k6$14qVKV8oL);LD}@Z%cf0#nA7cn0{j~jOh`x@ z2TgqCqa3ZVu%2xY+QODxrv6R*{zH*9f3jWcO(G+ZfS~*#b;PF2)0ah0t8cr^*af~? z99-GYgbuA;$k%oYiVGGhEJifI=Kx`XUfgTjq|(#V8yXqGAF1h^P?C;0w0=l^?gvd0 z4e_a{$ZuqIsR7NtQ4mVFh|5+7GIr%W%fL3#gP*j+@oPy`=7XC!FD+yzpWoGz@snf57~2Sf4}wI z!a^!<#26?}&GAAg-INajuyrX2&aK>$a9WGqNT|8f-UYk~Vq838u^=PLP~*02dmV|) zIE@=1Jr>>g&Ju(AozwNw{tp^$N4j_rY`=zR0YOBAl?a{drAn@TE%Ro&7l_$NuWjbX zb!c`-bCHfwDJFIDgc2)ngrxid9f@>ueVc%DY(~c!l@jL(y}X>)=7uXG$@gkK(WPJtkiQA+DePgOhVYe)!EIhPx1xI5)^41kw(mG$!EC;jn0KGjA zRPqnW$!HB&vHCSj`H@#2ZdV9VJsBoOzp=AfJ-5IlaT5Hh7OA%E4@wLwiDTcmKI3|c z6nDioqZ%cHj=~fVm_+ovkLLrC;Z}f4S=KdqK#{Pa#u{-4U0z;Zb4WdIJ^|=O$3PTH znpOc4c+syU1q!WP@p(?DQCLsWd3ED5ATa2a&JIVhD4UjnB zkwQws&<#Oir}8?Rp6mPWa(RA&e&f0;ApYI-tCRGU)^g7?=kqO>=5_!UB=^EW&$OTG zRVX)gD;tehz}-TN#i}h2%JZ(!W#=h%;N7-_-3>m=FGK&4+1Zk{{y2YT10`k|@PhR@ z6N>JZN!D7q7G{;(&P$Gk5%cMmo7~hc(#_O!&u_5k3QaWixw_UOma#7Z>KxJ(z1&M^ z&VX+2=H`Ys{e(GcP+;dHq1$7B4J+Mzxvu7?s@On`WLE5V<`R_}csmNE{^~8f`2xJ5 z6&tVj;j5&r*~T|KfVr%1eV(~(g_K;x+$)PBxCxQ@fm!!;4uCE|5$siR+Aw7{g8f~? zDLr-`PVT91vd}>@`Dtj>Ft#`2q(dfzNZ+$7+#FOIGDz9}4gskvKr&fg^vPaNtn?j3M(8JU{`2MUJkS^VmSw-yaJ zzJLYTyARIB40a4xLTNw9AhkQyv+ggY&s|UR<{vT6-dmh(R=@_-fLwzUulTJa(uXp* zxVU6tsz8x|^#m-9Kf@q;>>aXHSiX!ki>VxYSI+sW>iBpuQcFSMYmNH%w=>SuuP3T) z(rJ^hv9Yrpuuv7cx&ZkIS7>WZ#szELE znUHdjjAwuH&KC`5;mfpjJ2)d|gZL}1WFmDb zs;lGff{$GEKdjo!$}I-df{xHac7Hsz!R9XTX&sTsiD~7QPLu~5$_s3ytbzi0$Kg9q zaJ7IEgKP&D;2l^|SvZ7%6JYd644M?-!RtLv?2(5n=53{C{_u_!Cn+AIYO{*G*R_9X zWd&IoqMoVh07;VDSlyQ_1|JKbk-r+^m!tXUQDx-iW&bQViaF|${hDJqLxLjOJyMOV z+y2qJJu}7rS=U$Bh|tI?l^7pAn;YVp8L7~-Wxh-8FDXa$(Yx=X5J&7h_UoA4sMQFf zoE}4t$8d-%3H5)us0ST2@_#$}3JR9`GyaKK@wyUQeQ8B37Sz<}#(iV&q~4C(a}^EI z8T&WGN%BEc>l!pY#cI+5o|YO&led3Ox;O7!FH@bea+M&=Ld8dHLB|N`~M`r zV&?~>r2066gjYf~tV;sk-lR6E-g~p%NCY|)gpe{Q*^^Shs6a8?l|mjc>r-v9?07$A z^>}i2msJw0Fw-ob5x+u>fv@bJR9Nq;@6Yw|+O3$M6!b2g?+AL*$sj)|9}vU8 z7;=Zortw0#PD|Clua88~bw{;sEF&f0hiu}!{_S?5?W7h}jw|GETn08A3#05m+41$% zY%*2nJ-w;ry7+AlC#eDJrlqGJ$-pvq%6{4{tg$_B_%TXL*}XD&?_(okRK$>kAO9yZ zc{dV_p;PpGDgDNRD`NP>AaY43RYx;As4&= zBf<-;X{2xq*(jM%LI$N1O;uIZjI~gCd?l3)?0Mg~%-DoXL~$f{do6i@!|c7cnYx!! zJSz5Z@-9h{5e}6=;e-kTvL3a*C06@`!ZFFxafhoX@iHJQMNoafq3XQXfM%xA68aY8i7q(z$`cumS_3i_#uDC z^{@uPyQY1^j_MxOovKz1@wbiJv%ID<8;*wo& z@2f1aog&5`niyqu*SGel3S!z+9D0gTUUBzQTm3R$I#@aBQ?p)A?^9C^wj)pd&Y++< zo?dC^x|d@&B3E}N%{OJ3CCn@zNvg8|L6nWzMzT4tGY&{oL3-g|Gz1L> zX%JOU180Q%)vnFeUz-9pl5cNh!btLsCCh8hP3;%@l|M!;o93 zNfOc-szXVmbx4C%Sm}}DNch9F$eDE|MLjmwS2IOd*ni@^85u#mU1cS2CbqN)W1J!T z6ZyT;=VzhLjppj<%uLFn7s=dWe0z_=3qj+42+IpNQEYrXE$AQs6~NBpPsZj?4o?n^ z3zMWrjg8HdBQ{k2u)7u=<`|b@ri&XiTh_Z9yePXU-JXA~TjhRAh+ucctI@LEEc&L2 z^>}p2M#cy#G3u}Ics1M~+kagVc11cXvvbV5i>e~_93F=yNhh1PGi>bgzk zVTHOcSXbHOvf}L+oE4AjOD@eic;;>PJiq(#;H|8!shBJr4}U6@Ah}mEGiTM;?{|t= zN+{i_;pV6sV0cF=P@{W7fO&6XFAd6s-MQtKNONOor`Gyu1XHnV$+oLn_NLq+i~T8C z)ifbrNfvcV3nzcMn3jKc`UnAbRp7jO+!y`PM2AiZuZ9wm7{;*qCWX$(yV@-FU4NNW zNHGy9`g;b<5+OA4qbhfd-cKIQpAgD-J?C$cNEonxA3_(WlGA*T zXFGVHc43{2t=RG;a;5si3v;XK7-7chW;HgO(VCF!Pp$!427e0HXRYzW$ZnM8xxr!r za;s0TMf0Q5rrO^jY&Tr-eRjV2ctjFDV=Yo&GIW#_(qPnK_WGc?C-MW|EvsTQHX-6P zC?{rgn081WrF^;c zy-@5&;{8Q=Y`5}=euleUaic=&giB{68eKBsvVC$9*79;cu$7B>`(qpOzSo4rdGq!2 zMj5v#TE0>Dlo!2FqOD`NV^fAdLb`W$p+EmVb+Y$S)>8JE6)Y|Ap=z-oy)842XWms* zO*o}sEBd~(BqLK=MQn_A?m=+*!edxqXJl1-{QBW+xsdQNXz~!6nwkPF zxXg9e1Y(%@;^~o?9Tn_=baWn@p{st)k^t+guD-q;R6aN$HV;{$o4EXyaLhHHz4nG- zDcYde5&2f*ks+J_Cop%ib%6B2tDkjub-b_Ugt&efJ#P>2{`#F?R$O#x*CKFx0FJ9_YQ}0V2jcJE#(d5z#lj`^R`F9L$q19(91cZ^La1_*>g`pN z|GKXP!9IN;7~7CZ04*MA13=^k&hTbcRuVue0gP0T$dTsD^yY629#9a7^lh&_3Mci4 zydTCh?+ZQsO`5Ut64(>aN{h{mz8nM`M7s(qM62s{B0AByEZM z1@f#cTpcOwNXyEi!Kr9qgR1)aNaGd`@Evfb4Ke*M3-I@E8-#ZjcYVy;x$HS1I0BH_ z?)=ye6s>kRgwHA=m6kcG8mMjlTvS#D4Ab zJ|nAsbK7W$BK=zRII&XZ7Lap+X}@zUe27GPAt9oEfFK2a%6|%2DuZqtmh_;K8^k-v zU4dDYY<6B$l*!{A^zZ+QaPvKP3DQu71MgU_R8bRW!ApL@sHr>3|G>?iE=zK~zdnpV zG2p_;LkU<6pZ>*@82(wb$a755il7IkK1J8NO@Lv3jJtm*fP5c``1!9DZyCF&n{GnS zEs0TY=aDrwiXHD`N+?%b5%guyWQP}e%D(!uX1BQDHt$)P=CMiEP-dNHMt=1+ZpP)J zh>32%$*Y$3g?&zjef~`A$3a`)FYVmThWkP#x}w;n5>6B$m=&4hfoS}a>_aad7Juy; zzMAzy_rB^T^w_ON!;hB9#Bxe3C}4Fy*;__x#qIMgpzrfI{8j`pw~m&3>PUA5@^b(G zUhW;cChSRA_eN~u%}|JVJq~+2ZASoi7CRXh3WVI=Ul|MOaDM3Pyy{+&Rde`=Nky?C z+l*r=J`)rlSsM9-dAH}TqV*;nAn zv%gOqj(W`-arpoj;$fDfQtjOO5(C^=5dw$5s%@-WY^cuOnmi$pzrVMSIW#_=Y|W=> z>a$V+mKH#%*Xn+|F7^q&y`S29>@l$dh9{b;Z;mh#nJT(PY#eJjbUj3)U>6dyJovDq z^3+@3zB_!Nodh4lm^UDljQ}!C<>;tV=>8odVyp>$aSFMsF{|LqArMDfBhn-Tn>!Ux zufpbLJ`;S-jqvGT4D8-~J4hu>O(6M&0TW`T>~BtKl5R?}hYp(y9WQU{{IV#V?JiXD zcox+_A)=Qt{t^$X0^Q&Cltw&7XHV=r*_(4u1OWo*#H-uvPn}WklRmO*VgXV+-2U$0 zAUNUYYov@#n3l6b*{b7uf#L54iQV$BGdI}9ybdnhYK{Y&J1wpp5?&=ysvs~46+vn7T%Wgz z>fw%RmZBjnF6Q5u9Kovp8F=oIo#mmyoNx31)8_xuLaoUMu~h$1LiHy5`8+T)yvNdJyGqtWf>SS9YG6S zDgiS{n>teBl8jZLeVKJQFk25-cS+!luov&+s@>Sze#=z+R+9R2odUMBr%6GyDh(95 z@|^Qo`_HqB1j){Br~8Z;qYzVM+`Bf^mSMqd?Z`hRT-VA?%1w%D7>P4ENoaW=&gwjj zz5ApLl4JzEqgGWAevq}Z6>azEP#zqt++`Yrq=|jS7%!yK2P@`H zTa6|rZrymNpBgBZh;@EReWX@M(HC{L5IUHZ(E@%PrlH5~WX<};_vEV(qoGKt?hivl zqwkc-LQA|*4I0I3L?4Dx8H6>E|SxNaCQNaZ(9)bZ)N zzWzzfRTRg#(GVTi;5&^x_h0rWH6HyZH+*SyiyMuefZ0Tb>MP##RfCy@Iy>-YyNVsw zk(rM7!VRyhKJUzr9|P+Tt#1$dla-2~nn0d2%k9;)~9e1yS}nejaOX_v#LeL45- znu*Y2fN`6HXM>@{^@cJmn>Lqfk;)xjK5h>Sg7_U3zO0YcP`m5fZ@uSO`lVurGj}NPJ+F= z!lyIZ|GPSb2Pm>-6Ix#JKeYFGdyUv{XlCYCj9h3G9j0;hnWkq;rs^nTdw8KOnv`fW z_|42*RBtWP4SfIpRfa@w%c>T~1J_sL7zKck6Vj*W^}SuFMS^K?PtLsyhtWiE!3n$>o(I}GM%VpDva`-lj}p4!~}%T zanPR`7=%w-V-DUU%0Lm6M z@&9S*Dxjj=x;6@u(k%@NNQ+W3q=eKU-7%D)FqCv%iJ?VBLJ(BA1Jcbfk`jY-i6C7= zBi;3%x!=zk7PDAu-uJxw>~r=$dq2-JA(D?Ws7xgZK8xZp{9|17dikJ^FhCKD3PDXq z_gfR){6W>-qqze+2x}*G%<dZNPb&4aiqr&84T9~B@xuqbl<$|y3fpEk6i-bEy zF?zYAdH|qj(&&ET%EOx^+{vb3nV_{YKnNVaq>+Wqih{LdyX9rr^czGn+v@6iRL|CH zr7~3?ABjAu0LJX0`j_wD@04tXj5lCee*OL&KFQLa+Ia5RMZw~%C`P=r>}1~>NfW%U z!?P(#baA5vd-Zqm2oE$Y&W|JjJq~tpLXG!`n6Qgf85@xQOkY(k2-I7io!o!3B1xIl z7%f|Sy3g3^{0I;ssZ&yB+s?PcVnmxxZUSYB&Mj0K4n!s97}t>h)70yFFYQ>j%pA7c zV=-UbNjW6Sgsi{l%LQ^`UdOE_Q!ZAwrl+wn7Wgf=kc6kLIcaB%I>R4e({PGv_T zb4+0AlK;OnL-vZNRr3m8sUFS|vL9*RkeWG(ufyJd*HbBkc_XZBZ_j8dDU?>$hVp^6 z>6)BVECu!kmx?Tx}W)z`dc`J2c%T)^xB%0LKR&1-dgD2JTfsORW>p8#N+vot9bT2g-->t&V zPu_go1Y|dFD7N992DJR0PW;(7YCCm8J*WHm9w9^2`+{~iOY}4xpj&aw9Z)g>9lHqY zvcCjvI|7QlcG!xMKa{9R`uTUHgl5H7=aQ@xjAaJgMeYlkWYk<~Bz}ZTyo}b3_>hyi z>65bSzz2UXI(Uvvnn`D!0pu1Wz@K*f6J+OSJUEi`4_z@lE)_#!Uu zW8vz%zcMCCa#M-wVFv9XVe?20&@y53fS8|ve?)>^eriAd`;AT{m0%bEbvHiak3=9u z5;$xioPSStJHC~cVr2GHbHBC~@i%)d(cs%nNqhbY<`uCJ)q)!vAFb(Vm=Qb?+Vl4I z=%GwoXtp`$V1@hIO|g^I+4?OyCsHxHOzu)0$4El~k8w)kP_@#yHW zi<{o2!Dn4uz4aafw=tH^OdOJM2tqGc`&%(9h_hrgb}U zT%yPAv4nW@*AC5@hCgq$1{hZX`#$tsC?*cUyKD4Wd&hD&k?+cV-m_w7sHsyK9>hsS zNpZ>{>V=C2i+P!$KccwQjDT}eux~3piDvY>e0s$$l_rATt41Y|Q0gF*$Bz!Bq=$x+ zIM1hf`+$1I__O3_lQ3_#-aH}gOqx{LdsL(K)b~fbKL7i{$2} z3h);H!T14mOdTM{0onl94e!m6Ad`{V^V3U9?FxsP5W4xS}#zh()G=768HOZUUY|p1`Rg_i>M? zLTe|7d;2g_3lTL1dYN-Sh!!)y6(ex(ZRcAZf=b&DU0gpL=S6xhA`mMARzF=R701)L z*zY#I_8HM>Zuzk&_bkp5-Cq9QZuC20@%cHsnOE55ewEmD#&eI2LzA|R{l%ZVzOGl_ zNubRncZ4HI?0fL=1}+eTY`HU^z)?bfRKNO%Qt^nMf4x-E^1ZBsdGkN-h3aYSBPnpnH$2MO^#aB0uZQB^t z%je^HsCO-(5^dfXegLVze!epQd&9oxkO)tgZjlsEQ>({gzhwVyT3WQ?vj|1H?GK$S zP~cjIz_kE;4J75DeFJDq`EqLJcn$@R$r9Bf038Z|5y$jK!cpGFc`Nx~E<=TCF%6^IeFXSp~EueU;N;IiT_N7I< zo@+8bZOlzqSBf_^$+jm%*x)!G``0=6Yg9v?6**Lj-xEZJqUt%>_3vJZO8*7Nxo@qxY&T8K#YG@{hE2ITkfJQe;dN zH&_c=FWB({AgA%<{(FprD!-GPofFFt_pIX?)?PWqLhm-r(avsD6$5N4D0c%?jQ)6ioZpsQJ|_ zaiQeMSof%tH37A8-Dpw{KR97N%^$%v^Z{)4S&>B9KPud>hlccU$d(Sf{{U$Gac=QN zRV$jS+q&GxQN8zAg&5hkQd#hAr%*-H;!~+bfrjBCD1*bp+zaUF zSbWr8sw?msK3B+23x0-&IE7W=;ezN z2oE2WzS@hHLm~e99MzDkanw9{JysVmCVw|s@WJ=MTklD3>}p|`_XDO*Tgd7b_D0h) zMMbpErRw1~2I-7n1hX#>3@kR!xLTTT7oOJUoLMy;5PlI7eCD8N{9(Bw2XVhIG56jr ztQXtmrQ-#b&1SAtREdBjt?s=eGg6-J{t_` zOqWIZ@3bknWq(C$hmnqSHG zE@=@Fi7y_dzoDSW5&B_L_$ZRCYz47feNE}>rY!$ieR;q)*JBOUX$^VJu{rT?M*-hC zM1hhcXqO<4qw$|$`J|wxk;f>Fuuov}u2)kmv3Fz+hC{|H&NbSjrR+Q$70%9S{FjEV zRVvSBfgfl5)E|l$xbzTGqWWwvP)et&RAJgaHO0Dq_*kU*!plLN`QH(jU;u0c9yii% zgtq(*G0NcwLPm2qblkzgBanSW7!?_#kL)hbW%H-UdRvC|$;nnk_0fj#&h8p+*Q0|w z(1}^5bat*Sz@HX=diC<>EZ1DB1>A*129T5Ynp1Z+*6uL$U%z|U zjJ@b23yYRLy1+;1n>;B%zGLlDUO)G~xKwCF_+v{P+d=_Zyj@~!N7sQb#+pY`LIR2F zI09sXDtH7yp{oG;e0`Vl(&LuHim8rI-$w$1?Hu4uF)=YI3Zx9ra0}6qzI9{x45{-#KIE6AD5n$)gjfitMluH5#;J*5rF>7B!4}n(!=5~fPj`ZvA+^1 zRU6^?CT+;TzBV{&c80YqS~YR%pd<{VGvHiKvELX(V+?ktdl7@pYgI(NgzcT zsjno&&<0fAJT}K4fT1pVp%n$ys0fBce3f%(mD{$(X9G{8)0(DB&kud^6duLuP(?E5 zEof$aDgDdAAGd&XbGi$B?k)`pZes)xxBFgb*573|N$=iK3keI?EYT))zU#qOBbgg! zg5Gj|e_a-g6|};Z?2^483g-;GrR8ZPkiw}!LlaA|yt1NKVE9%OiDQvi`u=f@>99-x z{J9fg$p|&x<9LN1dK|%x+}@;c6904%XJTXPc>XyA&|DD8$Sl&A=(nT0xlFRA4Y zDMHvgcXq@GiHK?j%u5ge1dp?de!&;xA};o%C-3j}_Vs}e+@_?o-1RYC__rDfG^y$Dx#e5jZhSb+M7tZX{?OcE?lF-1WJFr#jSL6sV0Ge-^j?LfoN;4^7^&ctvY(tC{ca7gB+T)Q+F*kr)_>h%6|_ka3a0wS@?}{~`EoQsM=BvM))6ntkX&#C@5ggMy9x^Ar33812c+!spg zIelNoo{g3Y6iuZshTY?P0u2@Job$DlB}+};ZPUWiFO_fuuW40TMcis^?aB;SOJa0q z(ydE_03vS2x8X2%qD6}k4C>Io^`H~7pVvEFo6Hw003McGyB)aghv|C1MIbl9&k#Qj zRE%(Bd`)Df>(3+!f}ga0zP=1NE>+1OyPflEU7UrSDVJx$@jg2*#I|L4BT0GXfE(sD z)8b}PDe|L#J~?OWt$-5T%FB`CmR;#4hw`b7%)Gu@s8#rOjdO44uy?i~>ZO^PPR#Mf z>rZ`7@A{lVx+V+QU^y0NN#G8vR@@tC@qN2-xpXrvQUBPi=zE!cb}$(1&+)hUSM@pY zH3i(&QL&%uD$QwL*K~<*=k-C;EXuo4S&4|m?7M>0PQI?%xk>qmOe72`ac;%o#Cv;M z$bvfMiU*7!Cka_sXk3IN%;WUEz}Bh4eZwsE#v_i$>&N~O3bWLj=)}7kR0KEh@$rH3 zm7vF{k;yFs+HyJ4Vx81PLDYVpw_Uuap22Use4z^advMboV$p~1@+M%sZ#Va7^~+0r(aVL$%%`U{hGTzU6%YuSk8@<* znDwuJSZdK?kmTZ$g>nS;)10sLP!hx}gf1`Cz$O2`iJk#NFQ9C}1q@`GwK9Z#j6DHl zb(SJL>`A%J%^a0NJnZhJ>tFau36uaxgSeO`uoc3nR?|sF{e$Kq%vAoh#8{Is-Avxc|)I}lwq)LL=Q$0$K3q4d;(a5@WNlhfp!v<3!ua1%AE(i1B|58$= z@gcN^9Wp|vBf$7F|%sAm>5S={dzUVsd0yw=Sk zzmNEnHgAMo#kb3-cVd%HcUM`wr4DQi2jfizf4JSQqFp}V+zth)pxA>46`N8;_V!G= z(nBmNP)i{6Ku$!#+5!X{Zql0S`BSNVrGT$tzvB-bq?WHc&{bfr#-cMpT>6`0rC8nH z34e^jT}DnWac#{-JtwA}4yNX?Y`JUO@N+aXJ@DaZ=OX&Y+J03%wMB<#vZ!F9k$DXi z!%~<0cxUN(>KjJXWlLqUBbn|U<4ZFaGq<+Nd*Al__kP(s#v7$iqn$u1MJ`xsmi?kG zQ*x;DP;<2ootLCk3-7eO~p3^am z%@e)+bQ8OI(#S0FoEgfk@ww-;DHoPel`ng?Sk{E z#liKv`rY4h?2w>vsO*2&;=Pr7rcS z#%D04aFCd-tbX;;^k>eaT|XJAl&9VZ%-1Z#RpQtp%mpsFWxR{tOAv6u>JU z3Y9lV8SlURPR`ENB3u1jd-0LHyT!&DGE_`!q~QDuizt1-S7M&jY(XU|kRGIehIrD% zMy?SKWVH`m8|Eft)_U&GdC78MO10M~jr|*?d{3rJjrUzlSEFJx(eBoZMix~u`U?K9 zO}1c?kX56mC6aiNd3`xIJ64KcL1m`2dehqaHErq9BN|^Zi%@^3URTeI{<7#4qk#1a z##&SCMy=JQlYQ6g>Mw7-~B2herm$qsBeIbKehj2O_ z>;4MyWvv6kih_dsj=1`D(2-DF2Y0Re>>Hf0sdX9t9LwLuSe`g;04Li8OkNl`eVCe? z+udBL8;cV(Vx`)8;-*2MGe}wcElu5@?9j%8VET97h9y$} zzK$U{9)tQtOiqki?hQRUkm%jj2p8&^@H;eRgBns3aFuuCeWrYpao@%`-AFnKg*3QW zRaaQACV4Z6a+J(emCSS_F-aN~tMaItE!nGjvh}=ZzqJqD-aR5vYGf`|D}9k?6;Xv9ToJM6dDQoZy4CWx?!dvnDbelsv?3ia^c4 zr1>m`CwGb_zUDiBBDw2rd$yvts1Dg*wZAAY*P2CzgiI;O?t~rNojlW{>j{0H#ZfF~ zoDE4w`q*j7V(T<|Ec|9R`m`*5&HB5}cO^%0U@Im@;3w?@y0R8ibG7c1GBy)v_~>Jn z9>0-o`1UR60ApEM7$4SbUi}(flbm9cUrKM_ISR;Lpe!@aI|D@9z`PfB7|EFgQW}>S zw*j&k_UE@RFrS3S)R|F35eKWeNwtxG*fNnLokol4$cKoEy^TkOE8U6wm0Gk*5MhPs zo@p`dIgFa|olBjGHJ!1fqqx>V>$g6{-y5e$NvqPzi(A_g#(aIXu1}+EYE7GjSLsys zQb`1>V6E^7byKt0d$OC6X}eOFenziksJ*iCtVF+zz?ywwm-!1wt!$#Ay@Tu6qE1Np za1D>IY57F&MrDjG$yp#Vt=_jF)Yy-$kU?DtwaGfwmyhN8*Wc;c2U0BjBa>)7>3F#u z)nxa_dJ(rSG3$?a?43JGgfU`#H#?GGj|KgsG2slRFzT+X7D0>0o^p|~VvwJcTmqLX zE0?`GndxzYsZ0~iVPQSHK-$b>b&$)63s7`g2Ewkqrvg^8-jKhFPsZ3z|GLcf#vcBA zAg1eeTqSH&fgRhiWfC!Nc74F}^y?z_lLUM3^7M(uAhzaZy!@0_L!n=K<0n{o{Mi7@ zL?hfPpwxG30{iW)egWN2hDXJia&H#%sPi@Si|0=t#9TBWI=zw57h@b2mw#6>Od)Mf z82emBu{@ukib~f9%RhqJyfXVKvcGR6$@)ZWr3M&<-u63r@Vv9oeXBo!ZzY~_&D3A6 z;qUM4FVS_azrvtfhP(Tr%M6{_f+@gH0cFs$#0LAy0P8CzPf*gjIb0}BZR~5u>uSg6 z+&eL>&1y!%ySRNOMPasPxsiiK#{>{*R{hxu7U)k`o0arA2 zv3|R0(nucG+VAZcoH?-Br&Q!oWIuy8z%)$u4Y*&JKNR{Ybt~vKJj;7N@(W)x!lkk# zOa1k#^|$K=WY)%S15bKYe~5|if+`0*p$D8|HXb!YpS(o)5H)&S`t_85;fU-?Emw3? zP9N$IfPGi4PriK&Buc@vqa`^LR!3i?n>cSvHaPc~_D-fCvp%pOAmKlgW8|~Gze$iJ zh)tGCXsh1T5~Ybc@>oKPXU30~1QG5n{FDE@+EjIB1gjdvs>W$G!<>i0m%dJc=IKb?xu&@Lew9&zO)~2}s z#xz4Q3Ez<1r@X{bU~N|kNH{}0tj;6MNX literal 0 HcmV?d00001 diff --git a/doc/tutorials/docprimer/quanta.png b/doc/tutorials/docprimer/quanta.png new file mode 100644 index 0000000000000000000000000000000000000000..6dfb9aa00eb964a65833d851c89e1ac0dd048433 GIT binary patch literal 54149 zcmZ^KcU05K7q6@9y22vTr7OK7y@Lu!?*s@fD!unk$cmzLq(gwPgq~2OcOp_kM@r~L zYG?tI(Cdr8_vbtBBsrPP+_`6R@10vdGv63PeGLjSCbBzs?oeoHsu|z8b5Hxuox8xl z?~;0+Bp54@z8-pO0{!mXA*cTR`D0=!;_A+wfA46iy)+G;-|q;@wF$_(y;a6$>_|zZ z>V{V9Qft4u`|#;qve;;{Sc))Ukd05k48Xj%u~mI(NmRw!$lQG!E*MQ$^eN@fSGz^0 z;sZyam;5M|(G73k`Rm-!vAhr^_7L6C>qP@EEO;fKuoWF0z16w3{wHZIckT>kryqY% z>!BK7oC&}B6a*%d`n}XUhSQ1{sgTPigT+z)+NFW_cU}KS{$It8LT6hwF{YVN@MY+~ z*S|^c@Z3@FX|vA-Nj9{$@I3S58mfIdc-d;q$@mA|1Jdxn1FE6T8k!WfXYn(V0GawI z_T9Tdo2XaHZdaZ@VK@i!oKhKp^fZ^?J8O>7JZ65OT+8GA&gJeU{(8y(vA-8J9Q}pK zx+a`44m;X$IiVJVxOlF*vv`ibmD4}<+RXhV6=&rrX--)hRjKjU?bpJ~ahnb>XN#PN zRHmqlM};2Khpd~hn*)lmm5!I-=~jupH#9wcz3NxCH#Mbue0FR)t2*2tty86ALI+|F zsa_Y|wFwGl_uCw@5Q+1Qft-DYq@Lt|VX~|Vm!m=xym|?nuUz>y46Cm=IRIg3pLVnD z9HnAceEbC>HrT+kxmHZ27|P7X67d#QFTavPXTR1G=Qynr^tE~ZSBq#Big3X2>5&Hy zyia{E+WG94+2+gB;b^hwgt)k~j&HE4!uSxODADxCzIyXqyWG5;8c&kR{Fhe2!|9@S za`l$rgSb5mR`4*Q>y+MTOX=<%T`pN$UVgE2N{Okco-qizV=ck?xcznVS*q%i-&V0% zlSon43(P$%;XzPdf4!s-M`B#>yZNWm|FF(mD+NTrOMvuIf~fZFXnUidYY#WAaCJ&! z;J0}q%^h)*XB|H|Y&01C%*pJogM}>rmKsPYi_1M@E8vVozVK*SEMBv#vR2zv3Yf`z zyZy8I40Ar&mWCi^7O3VhGgR~5`KI=MlCN*}`ZJ?8)*0TBGijVH(!b;1`6a%i(Z}KS z6U9tr87S*WOq9uWUiTyxtKL#0Z3IeZ8JW+k2|mf6rZ&PF9CE-ZKy!%Zit{#48($W* zpfbQK*5DZEu>F%9V}f=2u+Yq>c)OV}@7%yRDK9YKvZQytE$#x9v1zI27O#KcMaNs{ zWOF4gb+X7X?b6LOQMwtr_T(I-2)R$5b z&Wn(rpV@EG<_@$MlZffo0l1t}w85-PD{1(FQUW=NpvSM=s-hK?}WIds<*o54( z7qQ94d8$l_bD;(38_aCPt5G2|YDjj>VqV7z}7b((~ zy$e5YoEj46-Q&lG7%q%dcSu4yxKG6vTt#AT<9!*aK&YtXMlyxn3^8NAx~e*JPHq08 zQ-NyM@Mj#*aBr99CJkG5TB z2W$asQN0csYJC35KHezBBMZVvrG=%$YM;ATz%BRQdf(RVChc@xk4cNRxvtMN?t}|O z)B}Zg;lp2JYdLw*^|S!RkQnXL(L`FD7+&3DqMp)OBlBwARdvB|l%E!eI>! z_Lg?7U$rBq#CcqyB%LrxH6hr!*`!huKno@9Nr0dRWxCsCC5wiJ8tHmQvjwAtX0zg7 zPgd*lL4{{BIBC~H=e_A!+|se6O>W6%t#+^aj4`tgE9Xh~v`gDpN`o9RHx_5tM>608 zV;db8ttrX9!FLjgX;p4g7Ztm}yi;1LY1iF5chV>Zq2&^{?P60%sT!Oz;2F=nf)Nh~qFP(GV0w?fI?HTGhDV^&m+0}JttYAyIbj^G z?E!b=o3Um^xd7Y_oez5L3f1Enkrm@~R+l^Jpj+*~e0MAyMw*@B`0O&5>0Xm5_3XD8 z=NRWVD-wgI$YAE#Q(YnfnE*@pLr=m5TD4}9`NhT4W6d7lj^7g%Jp8Gb-{!wQ1CpMu zq>fojh_=NS@)ufCwk|^H^~M{@b`XDHe%q69rgoI9Ennoxj!@TEhDV&=WbR5le3wygT(!8 zS=%#r3De45poh?9`Mo=a^k-!qIp6^|iq4Qr!=UA$pEr~uMliZLeddSA6A`L)L7H&0 zSiSP9#h~pMR@d>30@|jSlOz8IX^eSaOLE0?C>=9m%{tzG&B8xeUZpi@_tmFqRlpF- z=6N>68jMjn{PCB)Pe}1cKtO9hjns&xhFFgHaRs?ERBO_oE z@VPNh)2(~=wj-r+bv;UQ7*+B1#)0H=g@B6W;OU8*zYP^TdI)kJfdtStm007j@m5w+~voRPgH z^9?RG_$a;Ix+FIDc_S<45?q;@MLjJWXN7AXL$#;j&76Na`71h{jd~aqm@CA(yxZbD zV=VA&32d7DD=ng!Ih}1G$|uTQ47TJfE6vs(;rg0}7*@HUT@rI|f*{k2vnWg(P zLDLG7p*(qCn$M2?_9z3Kn33nLgR@h4l2KG%P|2m`b2xqy)?;+6Px`BPOM!Dg9INzmSt8HE6I&cmpiDF)sBX{ zY6R)0@wsXI(f8$&4WzwWzQd;xPsU_0TmoxXH-5kj^=;&Bu?aKkr0@g?ls8od803L8 zDfn0DjaAjAnl44Fo%y4m*i=j)V6BFF`XOQ5t~r&83r@Apt)w0EwwN|%-cjldic)Z; zae_Byk5(6phng9ilD)HJHow(zTB*{&{M#4!jKibhF_qEh8t2yf_?^(xH_$Q{kF3VR zMwo~8s{HqibeZkY=0M;i!V?(EFy!q$vl{T0u`Qz}yS{LuBvah1u+abkKvOUJ54%3F z9M{sC!6-mN8H~_$pxL5N!j|f!r8u`t? z{eQBE-Q2`9p)QYDkV_JJ>;Q zcmEIdw&~W3*HeGp`IhE?7!#KvYIllqI_%t?mV5ijScSx8doTQ*b-O~a$OyH%_^6aQ zdMttV$Hbk-;}$bFYI=U^s?3OYck4N+3i$uHQ}XwmX+(XJ(e8X*5U93_+ZIUU$cJ&L zaD#xbG(2I4?)`E8o~Hi($K-ctvgR3wj2=2`-1+uVqvh6lY#A&BOAQc?y(Lu|5*1gU z!?J$YB6lh@O=Y<1&EKhure!prs7BON;(pgScMJo$_AIBc<~?m!&MWJ;Uzr;2{on5P ziyQ^hhlh7@Haw{>aliZSq)E;C{%_Lrf`5bmzl~p9%TiKO*~$;}vUWZJtN5IxjE@ap zCm7Es-@U@AjC-~H@ZFXy@ZCRgNOl_L{TACCrz|Ne`^3^IAkECgB(<%5=Wc5vx;pZ6 ze(2dpYgY1=+R(*XyE_K{s9X(o!HrMv89y`^GR@$D3`ZhiUvifz^Hb z^oC7-v>rcfRE7(ROQf_u)$bADMv5o)9zb`p?Q1C$!aPyt-h29j_E1ZEzim6*%c{E$ z30`q^@)2fd>oaQrQw~Dr(JoG>DlYbaI_Hc;SNuqQAvr`t0 z%Q)UaesMNO;Uk-sA^6`E##v9|TMA93 zll*P!l(OYJi~kuEhx z-A;$dUk##u(SR!d$yeh*`1V(d`Yp!N$p6|n_&8ad5AR-6*ra?kt%p9;DEw|(yy}pX z8M*V^Y*IX+Udx7e`$^mzfaE1VPjlmQy+oTZ+R^qcxXYDm)WdH*eCD#nza}QFGj(!e z#neRsZ=rtdyvBfL{51vj7R+cy^kuaFi{8m)g`8y|ePMrZS>5?yTWo(Dtj}hoE>5p? z(G~OFcH-FBg~pK)?)2W=s4r{D;P$VU<3QQPOuW?iUW3&VhxO9A8B_HUrl(K;r!ZIN470!AS)8-= z*i{odrV^RP!$R&2R>r~T35fd1RtiseBLqA9&KfA#9q{4e_w$$(eICADm5AP26D+mimY{*=nFC{c9w`^{*BkP+ck)67#-Z7KaOwc_Sr zb87NG-cl#yq*6=A&V8GM#c3NCiH~ozqGM#9bdL>x6dN%P}pj6WTe?fe8oYzVg50zWjReUshaD*y#Z` zd~+zXF!Ijd6!8j@GSQZCe6==02c-h`$Gw^Rvp3>B3Xl0Rc%3puLAE9)AINH*E>Ca( z0HEx_PlhK!&Yu6$|IsP&5H#(RWOFsnYs$1{+@zhr)F zx9Hb-WlKvi?pmw?FMs6rm0V!!|o>-1C;(53&t-4l9Ff3C< z&4-aB0SJg!Fd zRf~82`VPCfp*ptn^SdTV*z}Wx6Bkqg%CcOCoi#CVm~=UKb=n$5KGSg!Fy|jSa|lrh zKM@+JJ+bO+48)AcjAcp1amRdSk2uS)@_c){SEDYQD0uqX#nm-Mw8A?~Ht`bY1!?nH z@7tz*`FL}+eoBR7gG`)?dwt59!K-4G#-}rWf~<}FD4b9HLDG#~8KO_ynA&ZDy+2Rlpw`3+22!+e2*TYNdi?isa=gZBKX1@R}( zRH+R@vI!gm?GrN^5jR*3l9>A`=4)zdwzeEO5J==gdx)P%CbF!|qRBI_9BYS83Wcq682e7e4GYXyPZT)S8yzB0Vi@yCrBSZ z_A-*|Z)1VV&aaK9 zd8M^Q*Kt1yl6$kT@`z1ITTzrsOO3vvu+w|ec?^6~)}PhkA8fCsKhx@57LpCdG( zgO_N4(`QxAIb@`-jgqAT^bsm4t|Cu101Oyw$x`F&Tuzu-R`Jt}Lb^dprsB!EFPdM3 zQn`}3Qn@C)V>5(0x8|_}!608oZ^Jfc^o6>T?eJ4kt{%OybTMj?N)KN?{_~|FYz(Gk zWn}brQpL9=xA1B&0vD4aq+R<|n*}{kyUm9v)G$ER`x)q5*0;7o?Zw&RdZRUIdk_d{ zU*E-)g)4EolDWzPWI~K3SYsAELL>4Mg0URGmBgu!UJ8*-EHvGXpw5z24 z7-S8&YaS9XaLi1hA`vIkM>z@Izr)JV)#e_*G{u*!o|ZKdIHI?^BQ73YJku;ZaeMLa`(eTqrdw z6GDI_x-F9Qx6tTe#-?jjr0P&xR#D;Z>WZjrnBt9rZ)<+1QD05R5^MAL23QQDBEPYX zZ99h!ohX?&>AJaBR3j@96}kjP(P+{xp(1-FM4vM;(UaUBGSp}eYI{j>+`xXg&-~>4 zgjagLVyrbzu37Q&($$B`Fq@&T&z9;?AGS~Rr{{EqOQKWYZ{Qcs=eeR>MefhL8lXg& zsT^{e7QxBlO+v2w;`H+m#zQPn5u3!Z+>j+^g+6^&+3UU2;c#M-a|+dsK;=nORhICS zQ87!$*Bc-B-UMBbA7RKQO~3ku;#ej59(z_5Qa&C8+k z0g#?+CtOxR`C>eYdOZK;h_?^5A6I844A-_>-TV8>)$P6(--ZN#jbZS~`&%|;u&jbS zANhR|TO-V@+0uOH{@|XIFlYcx9j<6JuZZ-ge0Y1@|8shM07GQ*xw zCjOI1rZLuVjo;iaS^98$lXH`_$YO0d7&bDsHozo1$Ej6HTY4eyB{3oUilRfIA!u zbukNUGf5j6W@u$NXr*vzWpDvAHpBHJ)_`aX?o~tJ#gWUUYyeZ&tAZa(OC!YaprF&E zok<7aD3(ZafVBuJcXxN|23LT1cAA4+=8!`jP~+U3t-dzz>7dy8-GOR8g`fjuRVAXl z{P(-Mnq&mgKGs1iZ`^byfBkY6V&jCn;5?R`Mvsmu8tWyg#<8fTh9)n2Z||cE%B$^~ zLlhdF^^VwEa>b(z_SLdC=oJ8H|4y|EfLxbTDa~7m_y_UkOo`>z4Eq zuC741ZiK+>U9*iXezZ1;swfOKkaHZaHC4fD3W*mjcavXm@wM_N(#VQv^iT~9w&Kn) zRs&{1$G^HoEt}9@k&p z);^bI<^ga&&z*-Wr0Lq}V>fomNJ0Cgj`y+})x2yotX?y<90C$5t6-T~&XWx>J(soH z+E;2jovOxt9e-YVv(X}BJISM!#!&uLGvqxR_+tP4;mG{e#J3jD9pNS+w=$g#qBxa< z_?p#9^H1bTs7u!(6oFW~t5CSSz_-9p$)&K|`SVqS*%2B^p77IeOetv2A=5!T+f<-f z+g*q+dwd`e&ZU(i^!NRf;1hP`)@^ukj2gUF90&j!nFG?Jdq+=>c-Qf}yMw`s`f6gZ zoVGWfPS|B+b!STSCyj{@9}4H(M>{drJuKERaMyY>GxJcnjR{MoxB$u1^?_jImb1qtzXu_ z7N?0wC-lwb__<0r$knWl_LUz5tFXeqi>1jw`%}l1WNIHikGeA}$Q3uVw3K(kIg&-A z=iEi;ky$`anSWS7VOn4to4mr6R%;S#~3*01YWzTeXGV*hK!fw>Q!+AOhb!Z}LEYV$w4Rsv*X~rg3v!|sF%wO|GkLL^#t5)??J1v?w zB}UeOs~Ttucnm$fjXUbk7>~jY*o*I&N>3C^L6fC%Y@H!C#QLobP3^PINief0f;Z7G zIYZ2`7krV%MYZIkN4#f1Vcl8OmubBHE7W)TFIXu;;DDfGRy66q5iK;3D`W!M-QV6W zOGuMwYgn`Kav3F0qvIDfta@SYKNY@?qU_vh1znSCvRWg93B{FMe8JBi3?(_6FVAAiH-0}yaH z+>p<{4j729LLzk@lf9l3$q_c~Y4MlO8``XhEwpoYujj~)Mu)&S6PqoBq*JubP0dWX zXi|jmieo;xLPL}Dr5<4sNa~ILWQoY9w7yX_$y5+KN3Q0qxK7LVp6BvVt>Riv&hkv# z`7s~7lv_r=^3vt7#6or30X0JniG!B0eBNdV40|3Ydhi2Q<)CPkGZ<~Gtf7_}_@kJW z;VN`T@h0LpqjwmjSm@}ggoW~M-J7R!DU2jPsGsZ5p_xf#AsJP`q z(3`g0?MkI~O*iH^4N;X}HG2%ETsZ`B++pbE!pX@ADnvr*V)4ce)v{46njmQ^2YYHQ zdAby|;z7iv8YmAuNs`a=SZQf0DQK*z>2%Px1BlN}s+caB8a@6PEX1=>%c~Cq)`Z89 zY#Gqd&|z*Hvexsk!0?NlK8L`s_8y-|E}zL#(T-h&D{Q3}a%&OPH0)E$^^m2MrSh?$ z0R5u3YT+^dE`wWz{s#snxxLK9Z@Ue+S6zL}(+$Ft^wzav3R9vwE$%P3cMq8Ri7X84 z2fJeciV+tZ#ehCSA5g*pc1EO8XtU*c8{{j7*XLZ&niu0A zs@>M^q)|6A`ghZ}<(!BWEFQ8K*EV(in8H<#Xn?Qfkth83^zXvLLTyLVJW}1R;{Ef5 zhlibw4cKZyQoWI8bSRJ{RN6n2<9t|7H&Vw=PGCp`f|Pk(4`&C?cyp!HSP1p`EdJ7T z6-vidS48(VU$oAv3Gwu;$Cee*RvJE8;UX+S7SCX!iqg{Jgf-RtBN@lnk#TcuN$Z~O zLV5bw*RPFLRp$cs%yJdyI$S1)yh0}dTAyWT@>Jw<1~$nyaB3d%!dmx-g#SRAjR4pP zA;8B)H8u4Fzs(s`#CxOf3t%V&4KasowN6UuNl?PL;TLV5Eaz7ra)o%8JF9-SJ`2p> z^19I}*AVSH3OZNOM3fl|qLI5;|Lr($Y!DS6C5?i}_B@!>hx&r10+v-!bZb z3%Y6sO2@Qr-?6;i2g}QwlU9N$_`%;L3VOX}cTn4iS}xH**G-{0Y^An1j`eyv0li** znS+u${v=a0>B8OSWE)z3*n%a@xz~0^{46j1lsd508z%_Op<%G8-=B9gP{Q|kJC$+` zSqn`|JH(ER*gq2*ov;5p=xqlW=LQm_?F*a9>^$O@7Y)hJUr4_{XYP107QW@D-7$x{ zW5YK)yAV1q)ufvvhuVt)u?6F6Ska>%>_s%)a_`UP5ioV9&l$NmD}Vdj$X*>Y)M_O@ zmIV324?B9^Ku%A1+YDIJq9hH%;f+;bylZw6-KPtUzb+FGLJLZ?tEjjNUf6}a&m`}* z(STj%LzIq(ZbO=8{u2qrt89pG*ib2m7DmcCq@b)gNI6-@SM5u6_^`wi}-J0x8Ni z`r7Jw0EDuCu7m=JqWO%@Ua@T=QRi=jcDsjM$A2WNVjr=^2{*qD9pc18W4p!5-@Zxm z_e`5#sEmxpUatKZ7|!-UgCI+bEp;Ogu6}0yVy6s96=EQhLZPbnphLBTWf#Mj^Ngjv z%%9AVW0cVbQ&Uqt>kqY3Oyvw-Qk~hG$JM29J&Yu!z`{U7K3Y<-im()f#wsMd;Yj`& z(rL&y8y%Fwb-nL|3dXs4!Bik}Q~?2bnhsIpx&==KYV&eO=+s_5CVvMoW@FK^f#6;z z#tqaeDk@&Zfvyf0mIK=W!-bsu>Q4})?3i~=(Fp9}p{K4cou7nW_km$UY%?5Qrueq_ zBn<7()#aa!U&c*;jmu(uDB}2fF`><0{&LYzAyX*3F8q9P9X;kTe?$md3A0mI|8B$; zyY?(|XrMM%)B3B$)*5NIa0y z7u@9SeLlPZN)1db%*2TZKxFk~AcAta{O)oJM9!JmTkp2#VS~@9^7gS2H{bU~Rj93G z_KtQP)>T|e^zyGimwt4jBrwyrS;M)<;s~)Kb1!L-r~o;B`nclBxhmMrpgp{?L_Rxu z$Tt@&%b%@TY9bP`X9fTW+sa2wb?o)Te5!NO2*NS#9q_<1?SWi~t>%iSEORY>&IgNe z=)O;Z`vk3Ia}(KWOr z7xzG&&qL}$S*7~~qBy^Qd_tW;7;QhCXM8WfNQsLS|zZp2FA%xaemwL_OwSld0jkIw5{xns6O zvNMKa#1e0a3Jb!$ZR8C>GXGTG`0q>XqT?WK`#T9%R#pqtF&{ncLxH&fTE}^E!?Xvz zHb#{XBmZmt8XcrB70H4Ywyf8r?HwJ}XT~24@aDIlZ&_j7fT4eV%B*N__p-MRT#c4Z zOyW(!|M@UQF$@DxQo^p`Enm_L(9j8*SvLk9+6o@4J`;_F_Y>(ps1_zrG+;34aIO;K zxxFGRx_1p99KUW4R0i*#rSW?tx;C@eIYJs}^Rpf)B_Aq0UN48g4IP=ViryZs>F(~H zw7r}UKquvgZDo6qE)sf``$w!4@eRgKh_EFwV+QmMrb;AI(wyXfboH(EMCi z+Mgc+UM-xV_q;J%A7_|AGVrB(z0*fteIx(=skckIDWF4c`M*Ma+HBp#by;A^lQC`@ zyqaPk6*o{-6d*tixJ#&m$xyx3&Ah<; z4OM}Yg=@~B1Ho9`8m3Swz_$Lm@1uq^r9F|F>iC~zT~kJy5~-PLptV)@#>(Z&R1QZh z`ck8KxnS`-u)?EKPcSu81Zoc6f#dIs8NpRNF)Ko|hUyv@0x_|r#R)B~k*J%LKFdAT zyA6OEt7`X%lP4<+*b>^3GjCsMP&6ea4Vnr~Ge(6bp`V8T>1GhfRq_;WaO%}oUsSk= z4?V~GQltDnI6*yu&O}$aTj^D&dhp5TFcA>v07p!$Ggp5KA32=sA>mMlvVF5pZeY5v z)Zh!3kvcbSQJF=>`(1Z$fKZ3^>gI6Cy%wcGVnDU!1zo6&&1@PZ#P@cZ`GlAHp+lN{ zrS(pG?vo^Rdbjdm!<}70lR1qF_c!LIZbET&q#c5IQ6BrLFs=?NvmHFF zHlZhDBc_3YTO>#cW-rdm~RLoxla~xNcFi8vXi}MJ+V0{X(gtw=(i1{nrl^fb@eO`>It1s7 zO)1*%FnRQLR;?0%;-`iY-fX`6XM1y_qH4MG=C~R==5^1U-U)S7Eb7C;8#{5%K2JF3 zwv6q4mw&afQa6?Jzc@l;1g|OxIEMnXz<3CyWWJ6*^lL_vr-)7?$6Nmg#4!c%@=%Ez%X9ao#xALShXC#Iqp*?MQ zi)DMi!KE_S96Sd%SBnmgzx=6pAz0j3OW2WAS_Uc#dkhP1nN86v+_41pf@WS`wl1c9 zr)Ae4?ORXN{KAzil**T&qA9L*$*z6kwR^~(ZRuC*i(%r>SM=HV(cK1hqBG7RO6?6p zT*~9>Q0F>_i|UnvPCYr6h{=@PfuU^0;yT~frw(;TtG$!HF=x|-Tv|Q&DG0|TYEw-_ z>Zts5_-nSazsP<5d>TKsDZ#9u)nfBu@ae2uI(Do2@i-t+z?`b|UCnHJ2+e>hm;kILZ~}75$x4^toOfI z(D>P5kxslY4C24nP|dWB(}M+<{FoBKRBKb`{Y+hPhlT9qL(FrOI&dZ{XRiYqauj&D z2M*}=*3>G6w074ja`_EgUqs4wvX=pvC3@enpnYnd$jD|5*w@xrP<3sVLe$klHpvpl zZs0#87R^BFYFq=R!a*y-JoxXCGVEiRnYa5jWK>p-U!X9yTEZ>WX77 zkne%{dl5Ht4Arf>0^L;#b9gVC#37&DPzu|Zeg0mK-){u=)I>xF=fVlg82 zuS{#})C#*+Emy9bZMF<#%KA*mqoQ+RURU3{kaa>qP-oyyR9%LmZF#M+J$ivFtsWsr z6BC^5Qrei3GpW7r!Y{^tNG}TH1MuJ+huq&M9)I}_1g&nkE9&E$;h7QYjj7zR2@xnf z1+$hXXLg~*eJcE4kt2=_?M$R z5vNsyUi@Pa@S2Xkp!pJS>GlF`N1p!I$@1ygL~aJAm%Yp`^nrRLbBIy1e*Do|Bwv>& zQOCqqzQ<$dS?w%^qO{p%)gV57QH{gV&b_dtWVg|3<}tVPeoH1s#w8 z58mjn3A@=_?u|1)J$WQ8CD%+}!(u0L;mW`3fv!e{Y<{m3MH$)z_0CvTqqu_(iif)> zr>iuL0sDQ8dB{4^4TiyqWKgl-t^n3{h&OMu((v&ZDosvZ$LXXqgIi00wkJ3@v*_Jg zo{-i#i&m}T7kK36$Kv)w*+exX5z?TdnWSUorwY50E9{4QZzd`u9ah%Eyo-^~qlyGd zOzg+f^<@oWKKQ?1tvW0q$h=rw8@2#ay4a}Ds?cdISw z%4^gd?**M`sxzqCHq?4`U4~2}(o<9Cc9R?xSoCfD5 z2e%bGbg$OQp#AE@nDW;UFLMDYGrjEGr+(`8W%juOcIOAC0PPBQWNPaJV%>F^xSZA2=)P_9$T`-Mrh@ z)jt+^15Y1zfM133r7~($1W*iyguKHVNL{xeI2#sXHdxxrg2yZEWQHtnNM$^0 z5e*p**hIWr?C$Co7v9=Dmm$KwW&vpTn`4&U=Z(uF~)pLfyMJCu;n zs~SC>j0%{v$8M*vK~cmtdw`CYW$@n26Tuc1yT%8q6!L&%c5<0)_X%F8$y)|oE?Tno+-e>&6^)f>am_f_^@ojLYFT4@X z@odQF<(Jq#zD;po2$T$dJX`eYrQC0H=}&G)BmZCP$BBY=Dv-`F%XQP<=cnotF4!0s z3A2|XcWeruHVf}i?Khvh$$UfU zB&h{2?LA6L$ip3qdgp%gp<`v0*s_3*nqa&vll7NAmnxYTgqpA&pl%~JyM_jUHXZ!r zwQ8my&~1#tBDWTSgxlJHKq`ug6|ii8!Kj(}OvDB!WTf*4P{nIt(QSD)Y->Al#6Sur zJH8y|s$GEqZ)@sQX7z6g%rDG430nl7W7I%?Q`7Ia&U@{gWD`*?JMnq%mX1Q=+LBnT z{RTGa=+Y-G7sOMVS3UA=Cjt*auqA1~uC>;H$u;CLF-~_Y*Q2! zRU+l9mNqcS8}W+wQY1IRK_I#(B}3YgBQ%_yDp^;NN{bp}`lA$NK@%68qu1>xQ?vSL8Z70y<@L3gSdvZT+$gz* z2162ag;J^OxCRmf(>*MhR=#@g&(UN%U@7f{a~SuS^DakJoI1~c$fXd})bOs_Q#1e> zQy6$dVuS)CQvDD3@)Os<1iBMa0p3ysd{=^d|kN}@a&O{2E82&cXLM=Dn>j5Cm`l8{eAL+V~x^GzXsGwionjLhq@ z`aFpK&62S^LHoM3?@`F*3p24CrQ;u}<#y;bmKow6$Q(#@=ube!4}!hOw}WRbDjh^jqe{%t97ETvprmu&@Qm22U!Sue$0orkjD zOG04+j(*}*ZeJyG=eX{r1enZcR@k2H%1kwk#qtW~Ha6@j)_LooQzYmZTfVdeueMGm zkSkI;w0(QB- zY03wnburAmt%E8lR8mum$x8d_kXReU&20=Inuib`mZ{ zaDCl3EzUS=t!`uvKRn*dWFSin?tFbPgt8;MHOXH8?51MYu?}*pvy&FngiEHtm%=_r zoX;^TTx{?2ImG<+nme)C`h9JP9O%D-)$c8SE^@YA=Drglf>xZ_S9?{SjkryyDOYy% z#P?>G(Yh9il9vRzoy`s6x)eaJ*JV?{RbtaiB-7-+5HO?RRhHS7-C`Kll(S6DjU6J? zhl#iPGlM;BKj;Fct)^z9W@Cx&E0J=O=BxI;%)xYCBRdR~JNCLDZO5Yu!W8|}Z0Gsr z;G+}h{HOW(TLl7Ptm!IC1R|4KF9`oyew)*{8$%-i}DG`WP3}XzkbAeiBt{hD@ zp)baKyD!ZelypKO_73QDR&G8FPnu6;`JWWaM~s*HJ%B-{FM5u$ojyHM9&bLIhsSuX zbXqC>gWOz;Qy4u}x{k3V1t#*haK7UOmq58hvircfGPWf2R9496zj7lknkbM5@(qVm zxgjR#mGA~SQ-#V{=jAhR`fXiE)k}GNzf+FFRxnh4rL!hQ^JexmX`@uQtQtOf&-97n zFVf(m`krU{bc4G_(QT#MiEE~#?G;pYELUkVz_V|DW<&b==GWn^!*W7?xeL_QOI}Dx z`n7?g*m@26uOyadF!O!mDXL9}^Bx`1yn}6Lo#N>{g`l-4hV6Ev+SeQ}Gaisd<)xeRNBxwA@J7A2syKAkTw_3d*~l1;age2*si3|%^QACy3KUI}L zg8SHJHDqR-m0W*+L4^JSI(F>Wp!W`yRi=NqH@{qWSS-;7(oQ&@8Oyyzph87QfQFKd zYPqOgIFvV#lDns?q}BeJhDvzuGPps~%N35`Se`KD9ZDP2y5@XmWmh5Ib(*9th4TsT@67 z)T@H$%AupTN+`UUanLyFnYj44xG+VCy*Lh_+UnzvWWA}sZ!~`cf%A07=sXH``I;O5uy6GF1J!o~UW<3CJ2qP0s zFfwJ_K4-ePfmy4}_G^in!PZyWv<3s&klo+m{E}z69#x$7j4`p z`511drNUNBYFmA}`c82n`=8}%AO{ySv18Zg=j@OJ48$-0nuUAAw`Fv6vE1a9anVDznH2NKPuFTro*WP2%`ngY7o_wV~)OPbbxms?+8-Ok*GSiBO zTU$xOyP`?qB86X26_OdWU4$>JTZg#0x+TjPLXsr?Q}u*dF-K%Q;(Cb)`3DgGVx)d>IbBw4sr{?lREkuE+V|f zms*mqlng;5nV@^`jxkqL(E1ALJYBh$$^#i0Vq5sicov*2)IteGI2BDiP|S5H4`h)b z|6@Lv8*ZU!yCfSGy~Y5MQjj)I-H72c0y@YjL=#NLPH(R(O)>?<-_X#JrHu?m-OV3* z*pi#|`);&i4joxku(VbB7%$;`@OD8mcZ`1Sl}LW>V3EFV#Dg8FuUoukgmZGKX{(&UO;1p^prv$ zmTzn)M(692xlr{SRWgzaf*9E3`bt8>c&#)*lKH6_3q-K>Vom>6wxb1Uni)SCS}DZ? z+kX5Z$FK!o#Y2X2o4*Cs$OCkg_Q)>Bl`rxDCZ$!b0DCP^hm$L*|IEG3Lwm-NQCuUw zAo1$~?g&w04X$vj+sKM^{OaOriL!dLmsV0l)k@k7N%Bw;%(G25b-xVP8!&-Wrr^xxM;tY7>>v(k?J%vk{HGfyt0R^EAMC7&>Xe$ zZ$TGedYtea+HlO+n=~DCX_NWEoSQ}_oZXz1)K}Iahr6AL$hVSRC;s<}3%AQkEJvdh zdVOR(Q(|n_OF7E*HiJH#{Iq-PX0~{;+C^;QQTNJ0UGo~3thq^*)lk;$RdR8ekH?!g zLle47UVTg)_9o?lw6!%g`*YCd?CfZ`T9%a0$wacD_s!xy{wX^D0!yy-IxOn;ba&4F z@cVL_A@2R_Gma(iQ|Sd+j-~HPNk=1B$5Tr=!U1C%20j*l$hv73PcZ2l&sj{-l2*a# zrhmDtE_Ic`PNae!Qvt_zd6dPWZu~`^4??qGXO-S|hg+l5y=BL2*}p>-e!AvNCS=k{ z#rNwnGA5-Mv+hPV`&8}d-6<%X$Duu zt&Z8}U89wVA^l<>aURMR4X6J8yppR#OMUtzpCfCTMX=#zA_O+y=ZRBg5Fg;?b`)?^ zd%G6&W?)^QT3wN1TRv&6>iXP|B_zG5OT0XsD@|KhTYD{sLKR6dpd{^EodvgL_nxwu zNigH&(ANDcl_VqoT?k_QYbo)fxX#qsi~U)yUZe#eMeiDJsy%l++gIedJ$LdD2@WQk zF2Pe8rMA6UtIHIc>rPDFm2=xa_A3c zrxxFtU!AR{eq3ygZEqjlUOfHTcJExQ zRR2%i(k+>#s!}-p^kg61i16#LRpB9N)h`|!D7Iz7~zZ|Vw=HpYB zWn3iL_3;DlROB^EQ+nyb$;lLH05RiUODj%Hk)4psue6g%vWa_JWTOMTT+T-;_<^j2 z(SfYbKsHxbhv{K(jpH-2TB6Z*WYRW91t>>4zK;Y)G+MKqN5`>tplfBQre?<1go=WK zE)FQcBC^zPcau~x3t5rfBZEg9;xrDZMZg*!4xA0`E+)%@rJ)1=Gyv2iA(xw%Z>kO~0A8OCe z&N?=%tye)VAwy}7Yx1$X2@y||xD2b^x8_s%^T|?qkqy9Wvlq&@H<>=ZYDKb)OrMz^ zr5ReLww|6lwXGm&ZrW)ItWLyBec6k@p=63&4#v#~cfR)w!kb*`mh)nyj(4S7ExSe| zmZh`F1;qNPqnB<_smhX8-NzuV%f2D?>nmB!Q(~475~eSe6vf;_E>x;nQj2*sXCGDo zu=FR1A(a32g@U$&!yi>AvABV-^X5SpJ|LjOXMF&XIYih2@vYV;cO*DfX92~T@ zNnr*+!Fdc&C(w2)Eqzq6iyctcX)I!#&vwD=wO+&ptQ=N~eUy3e#!&hO>-ww5G7JSP zgQ=Mom6c6%SB7hql3)@Ln3V(vKoB%tqlIVXy_WCFBGU&}yXE9IucRbkldb5ziMZxBhj>;kC5y?+3!NkaKL2C3PkZ!n3x>w^2icBP`1Y zpbWc`sJihU4k9A}H^!HG%uQNo!%L#wBL0XUh?EbN6Uc6~Z%EW2^;)Uqz@CWlI9EHabKGUIQ{gcMv1tvYw-dFlrr( zlWT0W!fYdY*N(?@!(7I&&VFxG?_+ipHyNv}+VFjhj)yBxhw$hp=QC*E|2)p0!v(Y1#f(=OIjS0i@!4xU3V$7}Vg zteXFJ;Bszg{Db;2vlQ!=n*gPPg_;oG*jBg+FOJ7YFKBHOq$@me#$K+)@y+SfICvww zcpCs5umHHYgFbctN=|mNJM15=Z|g~^6Cs!rEb4bLh_aPE&0CDlfxWfwPnUM4nwn`C z(17I=M0EA)e5g8CB6vuzVIfY%hKYee6Sh+X&-wW3!M)!J9@~=+i_Pa_g4=MDiu*kX zvKjXPhgK!VxW<%~_?#OIj4y*=ize%`a8`;(3SJl>Y&aA^Bw~TQwLzn=UNt|U6?@3N z=-_woZJ|k=#goa?y#)S_JU5l2npWxK9sp5%O&wTQ(x>v42*Y-dIyfDd&8$~w?Vn_zfr^1NiKZj5-8h_g!>CMz6YaE#V~%5 zg~Op?DIlsY5tD?kGTEPjjQ9bn zij2=*2kR2&k!+TI`&L-^*fR$M&fF4oo{Wy1udfJ}gd@Ckwc8_ds3N+&qE{Hh;1>Gp zBHYg+fQaK-Ip=_%pWo%_eoUH|Fp!*%&u@BzyImb=Qb}f1CNrF`y834v$flEG`f>(q z6F;01_#^Q8%$Vb0T3T9U^ydi-RtA69f{T`c!#q<`oWnoy=ZOP(Cr|U{(m0+oRFmwl z52gV)B}T;@R;5Zt0QCjr;c)_K!*f{SfvoTxul2!H)pVg5#&-;hL#cwQeo`)|3{-&> ztaD(l!$uEwn-^U9cv+W;ge!RLA=(D>VoaMs_?f7M_kb*}9KofUrMvso@jbz)T;^Z? z0uI#1-Zd{|_6%;^U(9h9#~Bq0IO}C#{$MbK5i3SdPDPGSbs3~{*LONDRgB~5a@iLs zOC9H{X*a{R^c;t-l+qt@bpb~`Pz&bnwDhI(h^Pk`Z$wVYNZ3qCO5dZICoIZNP3|W@ zethtYw$x8zichuK%RsNN47V<;uJnwz;Wl@!2-t&f#qfL7Givacm6=}35y_~jjA{p> z8?3L-qLI%cnT1ldLeo7r8|*GV6m{4TlOO~FGv9ZlMs%Cgp7OFbN+PBqsDjI+FZUnP za+YN#kr8<`;Ugkg>g}e4baW5HVf*j0EtQbtY>M=@wk0&=q)!nl*KHd|`Er}-PRx{# zM>Lw_8Ml&~PH#v0+{OihZEe|J~(>UxX)GOVdA9mwkc&BFA?&&%1=Ix@wVZhxO>PQUY)>GqeAZ# z@q9!Dg-4)4jy<%BAE?8h)we9wzrJ@m?QW|%*5}#Zf*Er5pp^Bkiocza; zG^#(JA-tdGlcCWyY1+Qz!+UQ}ybZcC3v+oNVbBVc*^Df>l^kfR3g!kC8ebx}b*6~G z*|apGi2+lkxFphKTsGc&T}a(>L$Bre*4TA)Xsvq#;XViqKyD3Yt-Gnx_=1TPmGZ5> z#9UmmX3|D8WdDdWPw$!mB%~7cG}v}so!-JcvSN>}hSIPjRdVIMWKp#ZnZR=Mm0Y z?}JiTSTnyAu@{x*_bV-nC`EzkUmu8cc@d@Lv2Yyh{T6CX^f}3+uk=9;g zs(%j7ETtc9ApSYm(VC(rnX8MQx z-MIFs&v%sT9@RBhu%CWLbmeFMefJ;i$cUjQD`i>ySQa}QgEeomvwMA4Ei9kG_A&kr zPau!f(K-G$<>d` zay!AOAx9UTB*r*VA|?Qe_>hPxjxo+6&eAM1y9B*RIGX*FCCqxXW9Dv{nLR<)S3CwH zbK?u6RW^*>M&2`s6|;?`W!KHWeZfbN!kYKTPHXMvWeH+nGo2SDX+K7*CiYnK2^%B$ zzck|H3>1#o5`WUf(R3=4*Y8b*HlC^t1!=!BzcD7uIGFLc?j=F_zfS*Vi1F%`k$`NY zQ_pnTx#sYTZJUyE1x8z)@)R+t2fYB&RdH-tG%CPnecBFy0lZCb_EPGSY@>4JTnx)$ z4ZFW4s}wc%E|N&G|0^3J#}~lK63KS&D0OkmiF$2zF3Y;91T1iy2yFb$CPwiOl)qo8 z(qz;9lUH3u>+O`CdAiMS9;Igf3`;Vqmj7DHdw2Nh+IF^WGTSof_io(WUY5WTt4qMm)1{ zgh1*2u@!%Rq<0mY)vwekX2=qGWRTii`OeXPjvw`j!|BOS=7m%oi^%BNqh}8>STO|^ z4YcBigax|BAkaNZJ-^ZFYk92XL8mxIeFD&(z_w-Tj=KXT24j3sIlq{UxkaYTy}se} z*m2peA-|y>C$FjerzfjNxqhbg^etvx{W5gwpbVqWmJOBkY<+x$VL1vRYayEXYA2_s zPP5fE{RwP!t>+FP#z!)`Q(F!^jyJ0;(y4tGcUGuVz&5pct~qg&(p;EYnnb-rd+sk@?^KQWALr7@D&PAJ-vyu}|FN_3)U(KA zdcrmpvW{1-C+ybtCcFEgZQffvG@|YUC%Cwn0Okh=6HLG;^#XQv9xrSpx@|Evy^^lJ zn`n?8(j;}ADT_cfwO;vpRF+vDA7{1>vvAfxx7<;kVe#j_Y85iwJ!TR;q&S%W(B&td zK=p16mKgN;k|THkta&cpP$ga2R)++$~<{Vsz0!Iabb z4|ZcHhj?CwFu-j~EZfjh(^w|t4fg8_xGCF5 z?(2Vz=+S7Vd;##fb(L-mBZ^B)9UL7U?a~eO^+%VMmZqkJB_uNXEE2Zzii%L-9Azm0 zV_aVTZ6#oYwzX{UdmOxKepB`<5CFNp#2vk>BGZOV>XJ@y!e*~Bl?1eZ6_tfx>YWFfYL$}ewsfPHch%NjZb)u2sc}rARX7lVu8u3* zIty`=mbKYV;`=wQDbo~<$(hkFh6TGX{iY=p6cz@C&}jx>f}R0$V0CsjEj;`yYk2=M zXOGLo!~~!;asQqAiD&{iwD&(Y@`-{FWfvC|;{$C$@v4-c!y(LYtd6V5@BLh1g!t?* zI&v^`@$Xos8ySxi$D_khBm*K83)sa#odBdxSJ!^4pO}<*-?d?WrV3K3K}|`i$<*K_ zu{b_1AR(aw(qU=3@PVY+m)yR&o5ytw8ndSVDB z>FMs)DAdY+OPe#|f8)4|>2;R{Dp2q}jL!mb+{gGpMqgZqtn}QS1;DcuQJ5IGOBa)M z@Pf+9vF;Iwqr>&z7MA>GpUGx1db%N|6^N#Gn;+UJ=XN!{JPW;h+xn?wq%<84JvWj{ zRMKa%y0W$B)Mh1-`rF<%*5EW(i&qJ7#CYWw72zZTj4@^ljUMU3P9^|zM^x5@?ak5> z|L(%Ai$JOhx9MynbZV=3y{qjcle{W#h?}A<%u5*B9@l`IRAA-i9-vC?fCeRZ#i-r6 zg&zudbD7T1be}~QZ#tTG`u8x#H2$NnN>Kp(wYw)$-v0j&2`0_3vp=EK*MM6H{1bWw z`!9vnOHonE7?vkJ7E$>9AN8+;(2GrRzv|yVAjFfrEZJkoz2iQ{cy-1~l;A2fi7KDa z4f`Zji`&_RE_48PCyDiPKU+$`jSU?74?jTNysPr42)4L*VPP00mHqtp_us3kY`Snx zio5YBwPK&%wf1GTTHRqACAKR`l*4;s-pt74(h{MDXU(($^l6U_!3#nl!tLd;hNvw5 z^{!&iO|U=gd0L`Z!IwT%Uysx~`N8^;{V+8r-dz5%B@cBG(F;PCprFR`FF)?&e&sGQ zx4?hrDx+-a`8aii33oj3MRd% zj+@nDa|l9w$p;F;E$Vlpa}S;TZKPBKBI=_$=_zb_B_Us_LJy`_Ha_3`Bjaai z`K^g>9*C#oOJDs3)=S6P6s&ZYoC;u7Q6ea1p!nhcZ?S_y_Lz?HsU_sXwv1PA$7p zZN7iA=avrpUDtxzZny|r)>MUyxo@FYgJGgbRVIlRuVm?C-|YrSkwKc7X7XDp`GrtN z`_I;2wsCvP=K0;yI0@F^W(gw6hH+BpkO8$415t>2*Y8uP@2%eh=x|o$7bDxhkG_iC zbq>Okt(`mU;BPxyT58@!8wQ;JegisgYx79~z+O$eLr%0gbqA&V6Ggj2U z>yS%%>g0&jT`$Kr+salR*|u{&89L(c?0v+SzXlc>tGNAlAfzZ9m+O`EdM1~*DQ%Zc zEb8-afTsRzaUD++8_54$wx?5X3ANGsviO?4mywth)Nje7)ZHo-d>OOLQfJia(bwT- z#1G|+|N4X_UIobY8vPthgW>z121)K`DV18Y+)0cfm*@Us$As_p@PT|y^qsoJb`fmh z=&~xei)di%o43 z7fopLs+v8Y12uMqgg%YdR}$)6nuTm?T>J$#01?#u%o~9uB28aYUxk9zI0ivT<0b2` zu;AoSx{w|CIuMzgUv&8geXf^y0G$>0`BI^fC>EG!%6luw*dcsS&0N=#uyKV2J(lnmy@OclcMJWd2%cenny ziDQY8Ju1&A(`)fLsRJUufU%t2e%Bj@mJr}l_?+10UXDMIAK}Uby5=qZPz1Om;+}U4 zWQ&ES_{fGe)MJdaw!)A67g{ia9t0sCx| z=8@Gf&|zx+3;x92Ue-m`7Sv>N_gL}im2c6@&JD|cw}jz-s^qwO2Zjl8gXCHS;e}nu zSa3Dx5kv6KJAcq;5WPOLs17{dt9=5xJyovzN#b9hKRT*|dQ4cYYLhTx_xG-PL!||h`hggA zc+SPt*}>t!l+(;%2NPNO6IK?_WoiJ`lk&}IW^DW-iNjHoQ9AdkClJUs5Uqz_{O3Xn zgR@8LkMC364eo;-J*{-j>thO}EJsa-jC%FT;?o zMGs)}RxL-eQ%GVb;K`y7l~H{Cv9o8Q(fl|8Vml{p#25h_cW(&(NZ2S~VOB61AZ>h# zhgWg6(CP+Xz93dmUp2rxzp(MfnDtNL zo-A0vR;*<jmxs+l5?nI1_o9KPX}qu1v`G_oOEk+$JR#eys2At9xqtJ`9+ zb-2c%a}h^}B%P*pl;tJm2^T9u32VwDnry;_STzu8DagG#%~rldbcwrv-WX+s`byQs zyT;^U_Ihu{RFBjDUoP!mW z2na{;!_2gW(s%c_-C}DGD$Puv#HJQ4sa)$lex_#m^w~&Wnhf+|wT~UsXWqREw+d2q z?UmOZz)OC44_=K{OA=9B-rf$KEb%^H?Sl#kI;@GpG}`Oe+&z-~ z_6jLnU<%U{+Uz1!nmOG_NmIR#o<>J$t7l35aFOBb8%Y_B9})J1_CSWjjKK|BMCaZ| z(S5EzhY_$i(wm(>NJQDAagE@Kr!RN8#Y(R>3~&yN;g1zyJ*|=3lJzl-DuAA7=|Kjt z9yj`)$C8p&ZMQ%|<($9L7qcgpb3?Om+smY^P*M8!irPqpIWEfwm0K}gA@jakCB5AW zJEf?b->fl3&pmkba)EURn^T3CwBf~*gVyK9+ONLfDX1M#5O;iEKC;0EIqTSV{WLRK z7VK#Kt`M+iTYdNwsUEy4dv-#;-{P*s~R6Em^>x) zbmlUr^Z zg(=^}D0p~Br40S-C`zLsfOg(>5ZmlhOPBdl1V~CBf1aQ2uZ4SLQq}O z<0v;~vbvgpuxq8#b%D~Ln)8Dk9?;#R=uKMydlu1kt`|A50WciKZ7%HRh0;hJwd_k) z_+3_nhXdr99&-*;rG~l;k5*p5SG+PKTs`cHWYx>&Wh#56S? z+MiL~_XAM9s))vb9)MVI7v(ujE6LyEY<}v;dI24mo0g#Gw351v|m3(e)YGx+M zh#N9*qI< z-1H`iUgP9$3;rbcwFVj-n4qMnob+p|O)U--+|h+EHGLLDBY~bMmr7IUbZo9zS)mC4 zVksvQ>Tw`!v?e#lIY$`l{S2KBTm^GTb1TSW)ZelZWR0q_ma*_GR|02)IMC07r5CCu z(=STZ7z%s^PD*SNNyIY?s4TMb8=T9oW8CW;Mm< z2Ddfs;`-=lQG99Ng=(9F?Q*Bht?X{OR5%BTLR@c+FQj?0zQBGX`7ar@V9fAEsgCx# zyWeC#zd2)MJ3|>=RVDKiK%9rFUr!gAmU(x3#P@!~S66x(T3fpk6SZ{ZY0e)Nrtc=4 zyaW>%e|2cgRcm6loBzC#Y{uhD_oKU$yu~%-$9A`Pj1NcBZy{~6ywx6!ETF+xDWGe> zs$Q^p%pLnB=^0Rmbik0JRa0xUr_MMOaB}A$kD)qZa_O4 zMGSoV(MN?PSWl10iJE!h7IJG5#^#?5&D=;7_M?w|RNZ=i_H(}D1de`G{tF)Ggo46e z(hebhWG*RFp;*B7-S__{D`aJ;GB4NE2Ovq<&v;U-`M67lRD9NwAG z*jkr;1YSG!SHU#6wzj4P2k*-ZffK9uo#;R$ej@{6w^J!q*y~$}&sd;jeOa&2nD*m; ztv`xa*l&rqC@kI{UkUI&UIT83Xa@0oW=W`H8#y}gx*9LkJX+^*Pi~I-l6TE+v0b5K z7H%i+`RC0x*iQ)0;iB|l24#q}j>`0FFmL$uziC`kQzN|Seq`t5D`{LnF}mQHedBkF zeT!2*7lw0GXy^_Ih7pedG=oi#`-v6!g|-rOy4Z9m3+Wl$ypMM$I7T4DtPtc)=el)p zBB?>TpI4++$=#nZd|Ad|`!YX|4a`p%a@F@A`sHKo?c9C9{9qae2?c+^-CQl%T4)ZB zK%?+Zatm{Zt48zD;UeySz%%c1h_+gw2VNZ=tj*}xqC&+11P{yCIqo;MPs5`$R9o1l zye!MEWm|Qma@`)kyleG7eGY7Y7OKR<~W$uBCXF8~BfUK4TTp?_Tus zd=9U5E?@W$ol%*)vk`-teHtcjQ31@cZ8etN3iyZ4+JT|Mua;G1MG@`YEJANzqN;^%#F|r-iad zPRGqfINVe?W_s>>owUOHe-jmh_=WZUl|0LBuxI-}@@_fk0z2vz^lPr(QZdf2|D~qZa_n8`J zn_zVjhD|G^ye6!0855#IGdiBf-ip1-!OaEN>Es-&FFOCjtleVix0WpZateGXgw3p? ztNY-ki1JrLjR%1%1-_7RqE>u8?p(H}%9U%|5(49h?fD7EckB_lQV*;Nzs;JSTl-E9 z+34(Hs0aZ=otsrHZ?LfCR&U_6bOSPhLO@y&DD>`oD|hsnjFm^zgfUfD?xfc#)BkvY z#`$yYR!uibUi0?mS?hfM*GH`r{TH%^dm1vGi5ht`RYb#)6h<8KWNb;sT*2x0CiTI< z()mI_y-QtwX_Oeb;hHc4mQoLvAjQ#QefygBH7%GC%y@7W#2CkD+a18!4jxOE2+pmm z3S2Qc&u_GD6TBGrvsA4UNr6H90XRxg#D|HyEB7;KKhwsses;bweeK8kmif&c>F?JaB=OOq`c2GfX7)=< zagW(bgOKm-?(Knt{+H~9n|ZRuzXwHyN8gK7R^(k&-E>Dclnn^k+xxe zBrqzYZvEIUmaoDXBsoo|W!ZscsSaD0xNRb57ashR!=-feia>!cFwsQAVn_PaCAL+X z`Au}FDi_tnBSaG`N+kH@mU-*tef2L6i26RwbCQCxfr4Ysd#X-HR@GBGEpLl6(--9Y`kB)x&w@iS8o|O_9`}Y?l$xwDhR?&Zz#Bc}c!63|w zet*cYCpMNGq>h?~)?HfGPn5;|oexKZ54CPmhLh+9Z~qvLYvi!6O(#A>zbx9@(acf^ zm+W3J*faQ4AsXJ@-D;1@@$)PEd|1Q;wR90?^ES#s`~W737_eTd(sZOw*1Kd^P{Y4; zO(eQ9f#bwD#k%f6F*0e(>OD-}Eak*K6M+TkMBTisx-$A6NjX3CerLNYvT3~~e~*>U z{7JOV55MwnIR~4|+S*)S)vRvo_Qo4~l(fi}wJDB%;mGQu_nVU(>fSQnV6M z(Q4UJukR=%v8B&mbKozK_w)hAX`bmh2c|8A=48fQiSK&y%>Ja*rdn=9EnvlgE&bsS10)It;=H8{uHF=aBX!ib7Eje&GCprZ(t2?`6OKl~#TI z3`voq1(JvLP=?TV=NOO{1X20Y_ZSwd{BSIp=qSlAzeKDq)0D2;D_SIxjS?x*LHHX0sO zn+69wWe~V8wni|FPNpsEI@F`HbZ~0rBJ;r%qz^moukvxJu<89Bt;3p= z3GO(ez9eNTwi{C!5}{CKo1PY$z@qzkf|r-+m*rP2D~uD6SI52GDwwuib7;R~5INhK zLz=@sVv8!Z{z>XUSp2Cs416zre8B??2FsOovow`UHxsMO`^~LZ9Kw%hT_U#sCZr;c z`b7O%mJVi5{+?|oO=05 z+rkaDtim*5T?uYX8YYcGh*Xi1Y>`2AniaUWB;84RU&Smol*SP5?{Au=@1QW~&H+xNh>7puMby&K;!5#_QuePiFqwIR`&l*{# zd_2~o@S^vX2SsO$;nape3(IQ9Q*3g3E3XO?GlRibsxc}u{RT|L?St}M%CDz0@4cb} zPS_=1FN5sQ`MCS9Zb#R(pxy5hmW|V{JsECR^QsLRUqOgX17YGi>vA3Drrmh-A}~L! zY9lkJf-lx?XJgKsUB|3^v-z8s&X0C2_a{4Ty?I(>RZYUI{4V%}D)?|C?_L#FoDZMJ}-YQ8u<(3W4&_@`PcrM^3dVphKaoi4WxDVKv=2F)t?SGsmHt- zSF&+3H^^*PstXFn$c4nnSF1RDvcosrY^`x+#JbKJu0sA+ql|tMkvR)7=0BfsHi;hc z;bChc^)|&)c)W64@4N0&o>CE4+Ne4zn4{lg5~{494mirX%on0V(KF8O_~`~8^K`~8Uu)QlFq*~a5BTZ?W>xSI>( zb*9?b5i9YK0<7`v`!6_6BvlSgq6l%6lmW-`z$@@QF}!k1{+9MpVD75JQx(9;4L;Dv z?DqH=mp+p@xJ{qf8rvOVbIf#? zUnLF3JrmSD2iBsChVu?pm9@sf$?x0x9ZS?>ri8yI_l`G1p<6$_6?vCvl{ZrudaB926k=$ZOd2-Z1$y{t^m~}(n+j+{F+W^U~wj1o(=u_q7 zhz{XDu@MWZ$bb5Q=YRHj+hmHQ!-{2>P^B@!6ot4eRLorMc?V}~n~lC;=&6>Gu=_bh z2$UpW{=6izsEe$MxBEn&$F8Pzs)C_Ct;HatoBX;010xYJ5&q%j0yy6|e!}OG**>+s zQ_$ZzIBz}l@*Y~*3H>;=$V8@?;Mq?`;xD0k4$bD}!>*}Z&PLQKFTS4+Q!Q+TztXi~ zaNKOOye6S4A}o! zLESQDIKT4#2;1+E%ZZP`#YO7e{7mg_o<8C}=MaLgI~zQfl3UwUdIW{|8Ljp=)fk~E z(!F?`c$mg!?IuCiiN7#MqT^0PqGdM2F%k&B8@#rty<6d))1_5al-Vp+@zZ%OKEk`07^J&TW=oeFzrTnXs!UL5B3vy0QKZi>kZXJb1vPAlN(UbV_AE;_jkrf)zaR; zeDHMD!9s9B_ciBur6J_B-g4Uiybm#9D<6twUuoeqGS?*Qfc9-<6<0> zKc7}jFRrgz8J^zoc-%03Wm4^4#?>kgl#L#Xp-2CGW!cV(BFdb2pr294WMwllAVMGU z(-V!)InlK@ll&Ab75_}x9lc1ZpRwT2S+!@F?=;7D`?DM-S2f0yMcI5pDIZW_^G<*v zo0NtBdx3G$#gm?B@n@s`B(f9O7_6k0Us^8L*0W`i>`xIxQJngpVa5XkbHgT=$SR`% zpR@AGo1@9H3drSBfH5wG>)8E5N3$uGSpYy`MBuTzz+?LS!b*4NdJbnPz+cY@tVpz$ ztUlD{sDC4wtgTQnZ;1@36~B&vV7-_TJ3jm~zG~k=@FZ!Qh)>eG&vl4zTM!TG)-R1L z*9*MVSv3Po_PU@c#huTUH)`nNBJ!xj)4=_|Da{TufG8dJ6;F~%*Vz%C`P}IRk zi+HnW8Rq_oLf^}St3h(4CzqYdlyzgW5;ugNXI<@Af;>ALE@6h>h6LO1QpQfbs6!Ppv;mvzd24_&`nx^iH2&cre(S%K>OcF4UHSaK@3o0*sc4>)~$xFH*iKzp15a~}W z8bm62%`aqJ$?Bi?YaMC=Rrv2nGmKpd;PM7^Td$)vrBRt4*;-`g&TAZqChmGd!4ir# zUJpvL;&F#c3)GB2yd2bgqOfjn<`hr1mp}15a>`9FwNW@tPtc?Kz&>)4`2m*G9#8LI zk>%$cGwfMnhGlsT_c1^p73}sGZ*tvIBdov(74M?GA)`jtgHzqkqLme-lED}G;Y0N& z-Ef7kS4AOgF)t|Vx0`yn4YiJ(HJeCN86}dP5Cic!4!=Of~v@|%-r8<*JqC+7%iAqx7^MBzd4dpn(H8} z=KZtoELldp8|Wn8 zDx1=!inzg0Ns>aq%?m|fhOFAAR5`QUY1sD?cXk8v-qG%+&EzpFXH3TP8A?ivC7*j3 ztUQ3RWap&TjpegtNl$MeBao;zVt>&E&>1xtNz=5XQO;>2X*)$snEQ!u6*k0gySJB1 z_8tWf_4F=xp&D}W#P-adYGJ=?G}<5CaE7TC7f;vD=e)}L9`8N$M)El>fK!r4a&vww|% z3)(moL9ey+6~~Nt(+Ax!V^^Y&xow8I5c)xRHGv00oD<9+_xWKdWF=nU74PQMF8Scp zoU0>xGOSn*`BcbG>S{c1?Hx=XxOS0i<&2 z(tL_xreDU9oshbyQRw64}*d5-1Pn!l6nCXBO#+;307wzX9?2`x1|O+qZN5;%J#oRlb8s8W@5kLr zr13)pUhZGZcEoXLiqEJ;LDF&Fi^(HvbUCEEAC)FKIs|@yC$aR70lC>arYP(GZNN*Y zgWUst^vvYxdp&3a{fMl(!RCB~oHg+zSf+Kpn`#zbr7n9t)0fGL@#Ry($DtXT{bACw zbR}~TNb7Y%uE2p|C8;46N1j$MsY{u%T~tY;0&@e*d25Hw*!Y3X8iDO`;>3Sj8PCF6eh*E^haGp1>=C67oImzjtu z0mU5l>M-fEG&)+?qs1P)ke+@R_9p+V`%h75meS3hWm)YjGCSXK!Xf%12Kt;b zx{Je~bvjYkD@_|ou%Dl-R5O~=HE&Y=yNKrN=*c4bn+Pumo<8$Z>3}(}W$kN2Hs3Kl zb@Z`lKY4}g)_D)()uRjv?>OUHj*sYQxRl4-px>?Mt0aIHEMTvdc+2T#!1O}OKUf8C z#nkjQ2}?hL1AW@0oZy7%ZLbVj-yBux_evScO}faJG0Ab|8WgN_I<>4+e+Hr}-ien6 zbA?wvcL7Qp?puC8Eh}S3x7}77rTQihmZb4A9Sl1_Ix+DCRIVn21~R3-LmktvDh6yw zN1>)(r`=d&Ht8mICH@x2TZk{EVd6{{c6f9jqU>bF({t@U4YV}Bj;Vhc(+QN{CT%Xl zAYpvkW%LF~X)|t{HzTF>j_&YG2_^hiXS>{yfy(TKcY|J`-?uJe9XMl#-C{ z?v4Ql1PP^)?husjlo$>*d zK@k@7-j7`J69Hc570FqAjcn3jk@s~8Mbx)oUii#+H``EaS-Vd0Y~2lu9X>-ld&aqo z4`|g!eS*=YVX$|dQvE#gkmx|sv(=~U46#LDte&cJhwJQBXQm}hX0EG=cV*>~NdSec zSapS=R|CTsIu@d3Gu%kgefw(Ct=YmnB8q4Z2|$1P{N;Y8l%G;lbN*yS?)M0GpBd{~8(&gye_cMd5U7|>OtDUis4}%L! zxNnYYs9mOmu|U|V$76_)paXZA;m_u9djiui;oAT!=vA zZsRwd@H5r68gA!J-F{O7Q&zdzUA!A={Z<^kE~0L08A1@~nsMhGp+p?W%T2$5$!0k2 zMek(!Ta{G(8w>d>`4T4gSdFVCk@&iu8SEDMUPoO7Vzk8LTCufmu~;n=M%uGtE#n+i zvK3lWY))H`BG9PjAr$C)qC38ekb>{?{)=qHS%Ce*wlib5`aWB8^s6|u1~WWQ6XaU3 z>-x>cOb5IE*z%Fs4@{lvTJvIxzR2SwCC}2P8LV?H1FhO7lk#{eGn6g64m}?P+oSC7 zW!eG_?18i&MTGfodgh_;AObrr? z?O~d_%?lGuTH28_6GLLL<6}MF;~^{}!m1(w5%R?%AQUmo{TuHVf)rQXE-?uLALn>{ z6ulNtMQi(5RrXjH4Iqe!CJ=Ri3VUyUox2Ora$6fOp}+9}2#($~fQhjjNaMDf#OI4a zchmsB1A#=RA%f9>ZOX=0YvOoE>wt{!og;{53^hyP^C{>*Cbc6dN;YqqP<%F-WPV)6sun_kF0QQDj0^zUG+f7+!(8 z6E^7{{3#EtbXvZC?D7X zJx6eh+^G_zu~78adrdR&oqj76d-}hCfB@v39NAdv_m-Le3>+3e;s#Wsl@=pcQD%zv zvJ#8`>K1F!NZZ%xqA!`cd9bm@)vMg1=JjROG2UX`$-IPfW#&Y!5J!g(=uj{qEo(X% zJm>al{(Jk#(Diq3fUBD6??EqPDdu=#==!wmeYN0kJ)mwE3)WvrNu#)mgi`=BX{w?@ z^+;j;*;`^6)f>C(6!|F3v?vx}Rby?(1e?e^?^GSRJnNj@-IVm^7cut%o|<*NN~i?e zzgfYn_{BFr{+(yf*4fJPc69v8Y!@p8B%+9R+H}8{D-22~m$(|J9KnVlKUCV(7b0>C z)7)_ju=sUGKYWLlMDO6{4UTwB=N3^!jj>|LM&jIwn~;He>+;Eu%m&!t*itCwF_9%4 zjQnJM({}2iJ+A50?6Q5kS{W@|<-bU3(p zpy~2&1We-xUyr=sTQy%Cuw;c-{i*F~vf0sW9iU10>IS?T?5IpwJ;}(i1qCYn6D!pE zAmc*XJ%5*!NXfyDKm-F2lWCtV4HA|`p(}2712gBcck5t1#P(@V)gOH7!;%I8*RbR= z%RLi=0#jC~aQJ{(tHGN76-EHi?u3LA0mGRo!BUBAF>g&j3Fjs2;UYPJFPGCsIB0T7 zX`ppAk6W-FQNgSB!rfwha)d?^MRw6^nuR=xh4kigN?YO{X2FQ3-otYr>Hifa5t&T% zMqu5SP27~hOU@7;%M%+)k=Pyny86W2_!!vM>&)K5Vg@o9I{2{7#1QJ|HQ}_jhtm`! z`#}^Q_zWJ4CPrOn^i5liDBW9p_%EF@?1SJ^B8wL4)S^k>MzhWc>WW~cpC5kavgm%N z76n%HuSA)O#V=J+IzUP3=|;P&tU-g`6QHZ2X~n;ZWp9gkAm>vFc?dh|3!@_o++xq8Em3nYZvc9vLItBZ;Rk&Id;<5VQBvF|edY2-|W zpeBl$;zB5`cIe}H@FATJwzH<1fvU~W)k0@=ykH@P+^Xvf1?>{6B!-kfe5LSWPR@rK z(|w%mSyXgU4Z)Scbv~Bt=n#p0lDeMzW^Vz;S^Ci){NzFA(dMcSO5g(u;4wX>F9ZF2 zI$Q`Geer$m93gXHjXCU?W%j%0z`t$$-Jb#OSX-gm>U*(-n>*DhYEdeR6d*;*@>ws7 zk-!ts1e%P+R}X)aAXhdIGU=nfIfs`*4kQ2>U zlnYTIb*_A8Dtu&DLUk+H5N?Be%sdpGkt@kEJ4s*NrM||6bINJ9iVIXJF^_9TYfPjf z&5@7DWMA&Nq=jc`!Us>ER?QT5xubzX+3)6+vHs^XJB!KN&7y%O%i;@XaU78!d4nfn zyLoVLxigZ1*(16#`_1=V)yMsmVckod)S>IQox{}SYbEh1fG}6L{&1Qu#9rFvkS@YM zMjI%9JEV`)L3}9cLvSlbM)2o{KNt(IW_=EU9@w@+c1$M9rlP>~kk83WX#7>@2Rm;d zJ6ci#rcp(HJ3XlPF}?kNNjqnNyq;HKxFrTmB51!l?{zy4FwiO*A!Gzusr-_@35ey> z^W;Yq;6LbqM$$+-1HL1ac*oBes{QDk?a5ebtNeWGvoTB{=L$`Ei{pM;A2kil=TD!s zZ-F$N;yD@82ME!HPL^Ub!mA^DWJRUkr@AM&Eqy_if)x|zLIZDY?DC$akaGvSy3r~f z;|=Pcb6#aSxtj1HZU_Ya|Se|2vI<@qgyou=Fhsc_j#y%WtU}N;HsXz z*9xcT;Pc>e(akI}*B{|M>uRR{<(fMtq0DvRu69C^VW2T?GuuuM{YRfuaI(kuBU#?E z2+G2ub^TjML`{BR+6Z@TNhDn+<%s2VyyDCsKoDj3}+>v(mIc}z+rF+B7=gq#0IvkvGW|R>S zcptSLSMUqqIxBNYdIlecR}~rzIN5fG<=~-qWM9l#QLB6Iu9ID)&?wjdW4R_+@dfq6 zsfz|~TIGjPvAeiRBWLN4lT-MH-718UfNiCF@?c70KQ1mB`4cXWK_)dq@4BDrQJ)!dm|C}p9 z^#CGDX4gbJh`nX}`P}+Wf(rVBc>reW5k{7Vc~5W>7!vW?Mt4vKVF~*uOaJ|RYIq;K5 znb(_F``zCIWm4~~tT>E)I%7;Vlm>#1VuzSpK@t}f~Zk1x0hQothTfH+Qa-|nlR`)?o zL4Xixa*A3H#~IBa#Jg#VN}TpA-@yGgVg{ zBc7Ss#3Vut#L6-ksEhbgb_0dW#Vg1o?umuZ@wizcAHXt zCL2>s$qGhd+4=PHJI(Edx;9i^77x%_({SfHush&Kx>U!QUd=eU4tjv@0amVOO8N9< zGn1Xjl7pkLW7Wa>}sSDvc2-G9)5coT@o%}G}Fw*}N+d02XWS@*0?gKcl#1mwHjbO&uMkVndU;C$Q zin}wb37taWNd$ zOnPGI64etwrR>C$QwuHHj5~bBo4Dk05SjSsw+7^qoXfAEl4ovo&%_8>Q1jvt4sce~ zy?v2OeuWTjiw!))s=1a=VzCsE>14l_?#cvD)+6Wb-_zGwM_w6jZQ0Wg%A-mr>n1Sm z#vV6tmwqSL=+lWZjd^L!Jgtu<=`0D^1m#H#C0mOh^isHY@?al)L%!qCehxq~+0+nwn5Iyo+9MS17rW0iin`tsLR0}= zgx-$d;tv~PVbzSoKEZB5nUd6wufzN|wPW1pd2AKe8mq!>@1<~G+53E1)i221D(_t< zP6`;N`wA$?A9yZDnznqZe;G7b0CZshN*Ol^IgE_{xZ*gy`+;%pT9R*p%B;rV(|SXG zo>0^QQijtZWUEcL(}q2^=-ppP-^KpLd&Q#mgLt}qm-qX)IZ;o!?RTcUJ*hKpHUt(i zMPm|6@ybOFmYwFv%DmZ1-JK%yrjz};NIc3hP?O$~Rvm3nwwNvKXMw0){#Bu$Cm)e$ zX2nA1Hp51oR_Fv=A9?OkwYXt%)+XQ~D8l38w)QLfM)>~f4fU*5iIY+u|5?9RcpKA` zcQ?Zhj5I?Uq~bQq(A02E)sZv;64ZpnLn4$E1BKc&Cu!sYCC0FN@wBa-1w-X2#rnTS zg`q2ga^UHe2_t3qEOehpK4Bn^J7;?j`s67|gia_iGJ>+aI-h;jXSZ!{YDg}|Yx&Nk zW)=b-Q@Y1_jLkxTw0f93uh%wY*x29mctsL$g^NDomSJ@+jB^jW9Q>yJfaCv3xd|f5 z+#aG~;wii?PUi06O8bfeqt_)sn&Tv==_jC?-L;F#%xXB2Ko+K~s~1#xKT(XB9f{3w z-nQ006XW!Fb$x8n5kggvSEbJRI-T((-d6ek`omgq?9U(Z$qV}M-^D;)2(-P)0|g7! zx#B%dPnt4Ld5$!HS=g$;g?Xb%#CK$55~tG1HiP}hxQ;ENh|vq&%CRyoF#IEeI_f}Y zSLsHxfC$LL1I+j@bpj(B>PTv~o{oAK8lbjB^iQwFDHULmr9cFd-#gVARE#CVm-ULCSdHx?5i*Uf}RD%XyE2lv@$7 z(N%Yh;BDoc++Avkjmgz#Qk{Fzkd6=S;jG!Iwwk5KZ}DjoBPAC2KR;dg1Y8_(vA_{i z&AED?Xx@x59auWDCG|^Vt`fg&vpkeC#WuCRin|EoV-CW>IDpr5ypN*z;y9Ga+UL#; zu{qpwHBl9%g{{u6Y43~~(Zn8%vntzpwHfPn5cclN&W?peM~FY2I!mC$m^&ytRp9^YegNQ?xq?HTv65@KL-%#P`F@M zWryd#X5FYPVAf5PO;ES|AGL}hYwGu%+#K_X%)ibH9g(vY)(;($`rj1`QzeKB35!0w zA_KoNvalCfeF4=@UH4pDVR=cKBIA%=O}bF%c)G+LFT*yuptX0_Gkp+Qx2(|aZ740^ z{XYRVPs^_K-~JEX)nk`c-o}qw_FAI%u53rX?UQ);$v&%oJ!iII!!ytW%*Y-cV|32f z=Uf7z4u}O8bn1R3?|!*henxqN0Xm(FS`9xbC^!q!Ug3hQ0VjH`9wYd1i0A z=MhKZH%7$SrEG&`kFA624dgD;zyOkEBa?AHi_g61htp)5$6)vfk8Vk$Rv{*ZbeK zfQOFNa;+CJZ#yE}P`zZM_>0d5DYWmzQ?qj+5>y=N$5e~fH%-uI0kk0vus7vU&KXk` z-AuNCY#&g0mQUH$@rxc!#sX3RChRPiXdmB`dyu~|QD$F0mu@ep)G48ioEs6lk8;i^ z9mJ-8`HFlUKCKrnS)xy$&bP8<>n`5;rPyWqSJmXSoxY%G%VuI%@#So!(wH#w7Fu7{ zch^)9S|~eet6nrlnXo<7;y-}BD(9xmQl`ZyP$XVBAHyLB2H@l0sNOhtXJ54 z1V>(6UgCa6ueN3u)zjaU^D-EX&7B;VeRZ4(imwQ?r#d6|?qTB)NK;uKhSDAso`4TC z$5I(^t(vF(Cu^(_@4b8CM08jL01JeVL+-oh6fHuXpu__1*mN>24!=iG7zQUua#mE| zBCbx=o@Q)$eBa(#2iGOV*pEB`Z5WYAkK~}!OgE4U8hPB%-LH31%adzyYOFC-EXc(g zoE!b>8@*4qdxKc-|Lw5p!~SvDs2h3(^Ft>aTX`KyS(PC*U z)tYB4wA&UOYsF>TRNYk@`XnKJ)jDobeFF*(;T3qD!kH_EhEAyDd`K62h7gsNYk8sT z*-%ARMxvyR|3;6o_XqE%g`Mv+ML;LW1A9Cg zC>IY=)~so{W=qmW0z&%;2V1FwCJFATz&DYXzY=AHu?%L7uAS4}k?c@OLj zoTsX0?gb}0qFe?MR0F#(NTBgG;jp5oN7$U$D1XfN-oO5sypxDJ`K{$s+P+0qnDgSe z2#JY03J_f)w?1U}7;(iPI&j>eag;lG;831gDad%hqO9Jx_+kNt>3E^dii+Bo|2XMn zNDTzO6?wYFUf(bg&|#@M7rX5U_`VBqm}3jTnE`eH)Lh-%s(qG2ve6d1-_~j~+H9V9 z6V3zV-UJS-qYeWwK6_8s~^#+R)-{o{&J{A0aEFL2YkYr?6beCOtPm@V6vqrY*=ecFFA z1bDz83G{sfO3Eqkeati-VlbuC9twz-w3dWW+!qNkvYQ*nQRln6n&kM;o*5oVa3Q(( zT`@qr>ixox7qIU6MP(wxB2%|40oiTeNBYc>g-aJNzy6+H$55uqj-u+Y|sKu~>i2axxR352{>qS<}PL2uskD{I3s5$JZBYkx+E!J?S$pL>nmmz*FdVtaAzv!YuwI2 z1TNo;N#13BVG0Rbq9gJE*By~tK<7;AJlPS~nGc!3P zUlqwLkx;%&7`#_05i{cQ{e;)>Ke0{(0K-*{P~CJ%r;9jRdp}w|0^K$>9@#fRJsF53 zW@`_g-V{-@V{0>lsh)13FPr_(Gb(yjo^uih*DyvKh@dbc$qQf-NCWvNr|AGH!a4-W zwlJb~6{4H>?ryUEGzUQrySNi4rU487doVAqxh}<35NZBhdY>1|t#I&dUi@F*mYcia z^q=?l;1Mj-Pf$Gp0!v#R(sjVp+A_Oke!BM8w|F}zGpfIAPGI?Ai_`M?k2bEELZS?F zj4=@Po=bp4M6GV=t_GA2um)Guy1DOW9nPE(TixSu_Uey2Ctj}K>Cy3s|F$p!M>9r^ z0QPeJdg!ip;>9&OiKb3aefrUZ&rJ6LR%;s49V~Z3b}-CQWiv218iGqNhZiW4ZCfj2 zR{7gzz0FIt#-?1qyXdS3$ij+iQe-Y?m!p|wAeg~*_O}1rrbh5{GQFvhV#~2ktw3#F zBplInDpF!CUJpyI+OAqqVx~e;^%o1UQ0wu4LL~rlj0&yCQx-F8QpQh{zP4ee$iHmm zIduW&eVS6=oocH@LP&;y1z1-RX$#i!=&1i2eg8PT+JC#|IoOti&wkvcl91dXseEfn6;2@=@=csB3 zC|j$gpLkI8y`%TLPb8M6MC)o-eSI7z#Zk2vZ+3|PDghgShT}g1v)}nJlVAzl$R+I^ z@eXGiXzFn9{c)4 zwyH|W4&}GbteUq-t56gSz)}|q@|KqQGK^ZIzQ5?Q*%_QplR4QgjI!r>q%Y&Wjo%#e zv?U)8ygz7o@`{uM)k~`>xB%Od*)mGM+6-AOH>Y6cXgc(5=uI4`iO?7BEl^6LWpv2) zmt(ZRIk1lKBUIXBP)=g9w0}r(Cfjcn6K;u6kZC;FL~=_z+xysn&79?UQJ^akI)Qc`#d=DB0DhN{E(ebBb;Sn{*@1A|pPdz-EmVXkSPPpsc|y<$ z%7=Gm&bB0JK0Xcr7Dc38RJ*X#t5*H>@WecxGDbfA)XD4MJ%#XZMDA5WgMe0;zR%e_ z3L^+p8aE?@vHHhk$^ubk(AyW6b-@B@ZxU&LzUy!)V#EH;rjntnil=1qi3lqY#B7!N zVz%mtV%30N5fIgeaj}%A+kCU@EK)%E) zXouhD+KCcZh_v8J7BHp46u7{*rmRl*W!q6TbzcFirg~_%kSkRnBfj{ll0>(`c#8Xw zuG3C~NL0@8$au|QNJ?E;ba;MAd#*%;z-JrAx&FfD2BH*uNr;w@qQBg%e(1Un{O5Lv zL-~UYy~NOdfz-wqdV{8q7S3G5Y&fdYOSp8Oe9(cNYa?B4o=)Ll3gXWwm{ZT!#`!&u z<@V?TteV135H}D64X`o~IbLrEOEHoe$d(3v=4FP&bZGa;0Ff&K=m9x!^-3W0)H2-w zN6Yf{93F8URmX^f^Q~ob6Vn*+#^kwxtGk0?Psx-*d9Q_xA=}*lLg4;fTvMn9U^0t& z&mUpMJ`_T6;k$Gmnsa;CiTk}<^q#WcL(hq2hQpg;@cdPCB4=4LirwBn8L7Rc2;>$& zq&XCu%s3CXQVp<~n=(lJG)4=W2JL5>1rE;%&mQSX>Cb}?%cVI#Y}~)>s(Tm8xXm)> z65~n}GTE_5Mr@g+tu_))^c6rd0qzCU!~h5?`4JJlpUa~#N(-U{*4V+&V;h|XPWu9` ztWn+D`tae!;BbV}IyP8yt-Zn1$k2gQTH?mxeAs!aRbKa`G`hK)1M6$|B-ij%7agr_{)qJ^T{;e(D;-G^5Kf@o8T=pXhwJB{2c>8y!rEb z?0BAD)=+ko%%dpB(j8yQV{@UlNiJ`D?^FBCcPa|T>UWtI5pcMNryLkpsM_TKs(fwx z17}P&vbC(*gj(1P2BZHZqtG#`D1qdp@as|CnLV7a8k5Xlq|PpD=8u}(ni-+%Q~n$| zw&)~q!`lzM@yhduiu8dgB){<>uJsV>oFML6E+`d<3E22S2eCsz#h@)?QYsTX5Fub2 z#2YlR?ZRv4y)&>*cb@d4n>HKUfTuFif@aS@r5GEq1rAV1KP-#vFxEzsLs|HHQ`B?w z9{TygHhki=W^0-k@9FjDx0d@Xey`hwX2KWpJp0GGVK;$5%8B9{o)17`Jyum~IA?#6 zYnvc9HZ^L8M$Ot03Z`~+Bb=z%{{5)I!gx4M6Ll2Qe+)_ZmSGllPpv_nln)6&GDcwvJrNuoXL-4q#m001w1 zFDRrt&-JQW9ptP|>Dqp?!X5rJ?N>x7|GI@z#`nE-Q`EyL(apdZAOoTkojmu?c?kDb zpHuTfCWLz{lT%w)3#)pXkUmoBd*0jOoV90N>2mIF)f4*NDc*7yr)p0?EP!>?;T%+@ zY*X+<&gwAp&~qN6t(UTq!lg{VG%OkR1nGR~FpRc;^=ZH(%#fI486udG+S)@PhD9Ns zglEWexK%CQCGMDut?2h6rXM>Ic3=RNyU*6&&F?PqvZb1^7Y&#VC-hsosvrQtS`gv|p zL{$psr?0SJ-wdjz+Ujm!ksSqkb*^RYO52AqWauE1!_4ra(yoK8z7CU<5moKHJkgR( zPGVMa{lE4WubK+ET|jmMu^Ec9-C$UN%6i) zZ5N7~PQW&q7S_X?;UJ7`_M)_lQ)*4v7 z-oC9_JfL-4`@tmf6n|#vr@0S*e%rs^x&i$m0QxKZMpl>RYRn`}mc4 zntGmVI=Oaw-@7JV%jytch9lu>g3Q4dp|BA)U=A5k?vpT|M`9`1^!GYer|HCeN}P!r zhV6zg4=LpT)*cX$A#t@e`{Y-CqU{+2gdE@Tt!EaUBHaPVIVFLT(OD`EY>drybOpv> zeHu!R~& zmezB<5nHW}wvm*(-x$Fe7@X?uUsC=|!mr{BPUHJE1%eSOH?x=aM6WEOV04(OeZC2O zfaZh{)A`UqM=d{D>Vn||chbU0lo4W=*Va}nhK$F=#~_C+mw%%qY?8GRFN=9i;blKP zaUCMG6*Kq#0kFCP2`cKI41uSke0K$EuHv8*+|b99;!!rgKvCH;( zG8A{^jhy!xp;>!kOI0`E+wFhCnTSTZ#%5|9l4<5eU%=&`c3_Q4t6au~=jOx_ef2BusNp z(FJzCN`XKqGD-0s>u4h{t@5o-Y{O8B--o^SILI8%x91~2BH(`S7XFV-m|;yqwVx;I zURi4^695)xek~D63YwSdW=t@tXJe9zy?6BbtkDBuI zsvWgUbGw=}-^TCS9G1T)*@yvHQ@$RBSk= zYM=N8i7p`LVD)r&t|8y(B<_$A-54DuU^siwl@F$~Yk8ntLa||PZp$Z7i?5w(Z&ku* zb#Qy1;2}YM%^KjPx)W-i6PVd^i{K1>w%;Cl*v5SGdPEV{9Aaa}d8v?T7Yxfrc) zE8-o9O=FqEA5MSiR<+5qa01IE>K})r=ad5cl#8MTzo*=xP<5x{qe|;9xkX-r7(g1< z{V&TI2k<#fvL~?rKjeb&oRxLd8ajLqhf=wVuWjnI3un`k=Tse$Z1ugSKkG)n0 zbGf_+1ZKIK3hgp%-aJD?poFJ)!X8c9Sp>|r>YE{_70qjf*;NgzSck1RbA&wTc-?X% zZrqKEpEJP?r1;_vS61ylpuA@|*c##;1rgdjlVVeCoDZnjv5cgy!x1&WoOxNcGiF8* z*4ASL`uXhMEG%?oAr6|X@kB1T{;TLUapG$0>p~MnwvNSo_p0GTWt9jiJE@L)IkbSg zvmVTqG>!osjb!Ss(~IqGgcm=zP2BtS#ZJ;={kw$1-0Se$F1*4nMKHJ262{|805D_# zAcVbW#Bbmh=TDs?*;MHFf4~YEz^yatf=a)7NkvvKl;kYV)l@Z2f6RtRdJs`p7!ySMhWC>2y4;?7>~^!uvApBhZ5oD1y3K_a-9U8Y{hfA}H7G#hKIm~SP(JJB@iIZwcUK_CLT=$L|A(gQ<1@YbCg+|` zHjG{zAmv&hydSl5u*d-takHjYZ4YiA6e14j3mL#=RYiG4N1GJ+oAk7FpN`m6?+zSF z`?v^Lb7VrVbx#K$PAL93@OelE8IsN3`Cg%Ym*JP`1s+8|?#mIBygg5bN28LLKVRAM zQmo9t*}$3R`9LqT!ave-u9MAy$GM#m8^IZlKsHIHhzH)Jk@ns69U~fsvn3@BzyKG*oY8^TcZ1eR4oY%1EyC>{T__Ysz8U^|c z2kNh(27%>(J+H{Ytl#5|@hTw{v<_P0El@t+(gzCpKIHH~m1zS$w{9zIY!Ojc$VU%& zw}C7Cr|ajDi^)uV>D1Nwnps*EpLc=S2vE_NREgd}{L-oIa>{SxNL_P*3Sp?L{9gqF zB>yWRkl=Mlw_4Yw`7iMPHP5UQ{PzlyY}DLbIK-i62&5k+(pLsXCO7OU>Kc;nK&D$B zhS}=%kX#8-5zSHqw;AOA95A#6&-ovefAa4#<6@0_ocPGn$8i_zX20C5p z1Uw2OUvAc~Yxe}l0Co4hnI`X(9RL!oFgjGQulPHJ(F08y8G~GkWMfN18h~;Qo7s!N zDVDXgEEKpQZL@WDssxNqAr5o(UjdnZ{JlpOqI9n~1}7&3eUC66N%d7ZFP^u2hO!Eu z&!5mS1O{tKk(T}KmO$dX$HYccY>IVAM%5e~4+5jlLzv&HiNwp0)x1cO&m)%a1I`MA z99#@eXc=Ypn5)n%*Z5s|%G9@OgT8(oBg&4GEuvtVNv`y|3QBZ4XB)eH6&LJf)g4%1$QbNlK`YP_*xm)^&<%{g~gt?nX z{)8N`t)|%-k%oEcSQ-g!!IsL$^2BBtF3QhfV`uf2Sb;0RcBbwC6 z5K|wP{Li_UqIlfmv=gtnZ|oW(xh+FY8~w$~YVy|Sw>m~`#)Jpx8P}6`t4M!OpZqF5 z8dY#VNTbou_?^N4)Ava%P5BsFfhZ6n)kzAy*Ohef=!wM+_RObqsmr!%n~Y344(a!U z+_pNN-n$>q^{{N-Wg8kX_QV;NkMMcg#5R;4Uj!95^uChLh=1Jl2xc4hNhcUA^Zx6M zX#3+_2l&ImFqe=M)~=M+6q6T0E;GJ zhtV%*@OI(97Es6_s1nAflw{GB!V(_)<{2Tj zGy{>0Dt`M5jAlh*C(X1ziR>7)HVHS2o%#(awTDH0IyK=HL+>3|d?FG&HS@)himpCL z&co(Pd+JTKW?atnqk}HCKUG9ijd*TB1>}Or$w7`n&SY3m0c9j#yNPsXm+eKO*@$R4 zZ$>oVd9v(abZ4>_xLp4F(86c3*EvkuOG}yz_s~mTK0mf{s07nuw)FFLE-cN>(U431 zL}zS*+=!mOk50YgdKnf%NvSKght((#jBrv^{M>Cho+)@v82c=)V$i^7f0lS0L7PQG z6>;k6Rm%H_zHzz^I&qm6S3k>fA2EKCekPxQjGVJq?Sx8`e|UZ`os|sn`&+PQS% z8>ffV59q;Xuo|#U8|;98-|7=rM{<0%ysolhQ+~;SzOudzlPIt6lV+Z*x4utqRmDDk z!{>12G)=F62{HF`6Yyx@ov@vqRnQv>^EIh@A`$`&7sBLFHy|ovy%{z!`L0*I_GrCtZob!Bc>tvJyD_`pKQI3o89-EI5uBZ z&TiqNsZ$v_iZj+z8Ru2(`>hDo zTOaXF{iT*Xnbwrzq=pZJw9Os{{+m(Z3BIMTMMM{#?ni&;uy8mhdu=tC-Us{uSJ*rf zaYHB)8fEiuqRUam-^@JSJ>uMVoU4F)F+Q7&lyM=SNO}HwT)ZFZJzBJ!p|@xF$?ePf z$=SkwE{klQ>SuPE$ZhC>JM`JxjSQgtH+NTXoVaNwQoydf%HYBRDr)aRoKkk8QQBNd zO1(LIz_udHyq>+Qo&3X|_t9>95A&1V^|gTe#I zh}_S?(K7X;GsBjHbDfJx>r}dl1M7dbfSgx8*5mr9AGszLw#npvPt^xyY{rmQF?%sY z-s6VXFWwPE&1PiQ70RY3TOY>v&qHvGzUe!cSgNndt24>9OY11*lM(^N@AwgI~hh63ld7JP{$5aAHPiIT-yP9TkB%K)#1J9n9}|@B2 z$Iv=DoiP=|$=*wb36T(aC#>Hg+!gEBY#xKN#8hf{H5%KMvQztdH`OlrUd%GrIj zt_!o#wb|sOo?{#O2?7rO$imQNgW1b%ohk2~Q{f1+(m&eSi#nA8!Zj>!bMuRHS*RlG zN{=R{G}*#eJYh1bq%u{Z81bEYL~ps(O@ouSM;iXP&UPTpI!e>^n$}E!8kahsWe)Ka z3S5{R5^VzH_5XRyHqi)|c|*5&ga7X@ijz#>|%6o6%C80L!j zS5A6#%Dy6`T>U8dXY{*FyK&J)$JA-*uHrS{{$es12Ae(V zRyB_4o>3ke=1P*%V>NCyZV@LD9~(QDu1zJ!PCGk0mzS4UyJKRaqqBg5Y8_!DHg*zY z*m!<+bC9XpG6Q(A(*l_m(w%Q|YI1xM zd3st~SN8xPpBAX9{pa`UkodX&6N4`N#JIq(e|j^Rc1A5N3PS(%)`sXhIi658H(^CF zAVa>-2=PWqr9!py`9jv>eU?(YKK8-;=4ijatd^yOcE~cLhX=h=#^M9^*+Jp#)Cj17 zt3o_%fK5?`){Mj?qMzhkASSKHy{fM^!>+H#qwz?=9I^UhTB}Ekt-qy`E*2wjZ{rj5 z?C`EioeE2CF*KE(HadR;u(IDc4cWSx_&I4^=hg16vJF_ctzRO_zwy6KXFf0=m7Dax z{5CLSX<(sb=8t5FnGwCJlbg96uXhVn(_)(Ros}vRdifgCX!k1EL3Wf zmdo;?#VGEZZ zo*?C%AX|N}$BL;_ZYJ`?JA2Q!5C0lZF?)V~y zk64dyySolzzA7v)-^h^58}YkBc9OhPRGk0Ny(R0p+1YOWW!Us&)ffs+;fck!z zuU_EiwX_%|(UB9~9AhK*X+s8P@(2)KB)1^ekjqOShVV{PAU(8U#gv#`;Nz6#1q2-O z=))hAaWyIt^h@-FM)-nv-4)lx2bedM%nT)J+-c!4BjjPHvD@U(erp zZJu9|$>7|7T~s4y83>HF52yK}<~p(j&!NB{y3CUHTJ_NZ%^(X$r-xw@H47(aeqYHe z+;>jR<>Xe!-Is=!rWq$(EaL*v$~wJ~Y}vN5W^8j*XrinadFC5?3(%`a3QC0d_X%i) zhT)#=S8L{T!u_Q+at-r76i~V6kKOgu=+OModgl?Lh48nCnQnjou0I`?L*xDP85`GQ zU#f&8U>@oNa!$n#P7bmVwiBw4rE75;S=;YZ{mswM&#h*UetyKTgI*zCT8Zq&T4stv zFOulCD4j2=|H8prcq;6|b@6(FQ}lFHe`gh1nXTszRc(eIQI>;yUgFC1=s+^DHs2A36?i*P`{VC09Hi% z*;<@4AdZa``w)bv^4Qg6pr)jh)JRwa$}09>Vu1qMo-|>24NaEm5t#!r$8}|CGL#F> z&dit!hdGizvP>rCM2m(Ov*U=sB)8UcNcPwTa4-Xl`};HIRe&AnHD&a-KoR@-DF?EUEG(?UA2%DT%%3xrnRRJ^ z<|MqraT>JDwTlczi1-v&@K*ngx@k53!c86}+rI4lj2Ne-6P zlZzJpnyRTM$Nx`FR~`>l`^8gH{q$ODY*`c8N$SPhGWMECO)7?l7{XX4`!-0$Fvy;) z6J9$b+gP%dOe7;=h<8TT5yK4G*Y{qZ_jmrf&;8u{oOACv&pqd!^Lf6fdQz9XNsaBf z`~W|y(7HS$s~aC#6;mU|x6AzdrmU1i1**H2m*Z2UJK1vE+NXQMfdHQ|4nmjWKsI zUxcuvhISA8&8=Z8Js~5etx@No-(Q(v%y868l*w4KWPF(u+PlzV)h}L^?1#8PKjY-; zik&Miw5xnGG+$065=%=*s~oxkNpfCbq@94|+_Po*@tz+hl1^vNNh8gCkgeXo5|z74 zO49py8JX&2ZAPX`I$5jot8PM89b%o3Sx#KdBE-h)$Q)#z?w zjnBN=dO>m^v@UdtC^|HQe26mZ|MsmIKxrzoti1(?z#%<2HpI}`&80VIg6}wx1JmJ9 zWY3fpcuIdqg_+x2^VndIlgUQpH@3nNw(tB5bNS&AHwqo`w}^0dMahF1eG@(d(;A21 zezzgwO1(V-lD)B*(-q+6eevzDh)(Sj6U7MB4Gsrd5Nj8@+ZC6dkwJ5>Q|{)$p|IGU zZ#nwW(b2rYbGAp_z;z%Y;O|9k(k^x37CNu`rZTI*xuk?_SNT*+>?D_dPJ99SpPq6@ z7E=o{u$cG~a?UtsmNC$3N8S^7Nt1ieTPo`Pg2yOvwBOM} z1W5@AVsY`=TrUQN>jltnPfJT{XlMWq?#e@=JG_yatlo>JzSiaM8GWqOrKjS$Of{=#zs>s={(7h4pe)o_M&3}8Lt~XQr9BkRVb!!S}G&>b9Ze6kd z+RB~2x)fwyTekD#PN)g#6`0nPaulf7E-mHa_ei||Ad5hVGs-IgX}*y-Pkt|qis46b z(lVQ?-Y@m$<#xjO40R!fa4DFybXaFjr^!=cu5(Y0$NV~68yIlbA#JgR(ej?v5Eq%- zH#@Q8iowKY?WPsezXuR^VA{)ob9{uB2Zi7wY})qc*= z68JFACsxxyv$~0Zaq&ntE|J|rTK78>>Zrs8AV6LzHj`_zu8_Z#aC0g@)w%`_=8<(M zic1~xXU^r`)e`$(_}80@S#6Ze_I~f%{U_U{q{)$RU7Hxs{({%3al9(C5~<4d_AtQ? z#X=K!ax*T70se zjbiuKZ}oo0IAtPY_zKm=>eh<)MWWB(aeAis>rD+Gq)FAA0$-x^a%P8z4R!gbWrzju zzet!dI+g0n{`n!*W^bCwWa3DnS}q8H@1cOAwz$NsR=&(P&q)979>Y`2D<&7Y2 zF1Z){liuDhdw^!7ep5(6{#73;O(-jPq0D-+d>OZbStST@PGp`Wmm+xx{g*Z8L)k~% zvXri^O(?o+>@;r9ScS5`t}nK1yCa80MMZ@K1+zoq%6B5;*y57?R%eL+N*J9?oar<^cHZ(~t??@~A~CX_sBs(E9Tp31 zD))Vm^!YE`RlUmek&(Y_+8NOO1`>&CVUm%NAu9S_ILe@9V>Y#g-I>>+a$wBF!x##2 z{vp*zslooi>}Z+6fCXcVxv(Hq@ItQln2+jdcuJCA`Erf*Ao{moFEdqOy$g3enC3GC z-Dch?EI1$Zuxxm@ZESI5Ra3Q2l;c2crko+kWlo$^8-FUvp{?LFQtnoTh5`)XF~9vM zcAC(V&hh|D2va8ij{@@3o4IlA4p$~+Z!Ff{pY8RGHr)KzKixFc@}1T{E_ z-D6>jy>0_*fA;B{qV-*LQ%VglVqMXVWLSaU@ul-<7tVDzTFs>UPkc%_4#G6Oja<^X z*9O_IFs!$8EKo5cg)<%DzVz#TA*=bZ*d*%bb!F%2ot>-hBjEQP{cigAX5#asWADGa zr?_|&t4HmwB&*WD)M%tp9aRSQD8n+ZRp$p#`T!K!p+iv<)rLz_XFc|c+B$P)>mtn7 zNduRY#z;Rfl=RPc{TGtA7Qr~;k*_P6%Q-0}U`Ad&5hf}=4PnSEU_DSW+J)CTgU|_V zCWt;TjDk8D2VzwelJdoZETH4&KPjWZwI3&BPegk?YXj>*p5dK2It{@rfve6rsMxag4a%SceQfF_=Lfrhd?0JJC{8;c7pdc0eRjAMg*mIp>biVn0u)45p? z%p?VqtrrX4^~e|a6T%`WE1>Zmdi08Zf^}GE%m@jNl#hI*5&UP1#&CFWXu)OLx`Wy0 XP2^a~Fq@6K2cCl&ni>%G9zXvVnUnH0 literal 0 HcmV?d00001 diff --git a/doc/tutorials/docprimer/xmlval.png b/doc/tutorials/docprimer/xmlval.png new file mode 100644 index 0000000000000000000000000000000000000000..180729f90d3ec3e56447322a12a14fe10223f4e3 GIT binary patch literal 455 zcmV;&0XY7NP)1v#7CM@Y0XJO?f}1XG`X7XXP&)NDlx`0F3Ei9o2N64nU zq}X>H&(8U=yAc1%Ae!x}KL=~Jt0)#({%hz*rNZ-I zki8U|?W#hll4=mmcGX+0Mz_Z+O*LFu;icWC0o(%DF{ftkiaY6v%~*Xm9ESmL0bBz23H#60ZV%EE xx^Ad^pjtAiX>#qaEWH-Mmw?BVhiYMO#V1*=(^E{W_KE-i002ovPDHLkV1g>5#{>WX literal 0 HcmV?d00001 diff --git a/doc/tutorials/docprimer/xsltproc.png b/doc/tutorials/docprimer/xsltproc.png new file mode 100644 index 0000000000000000000000000000000000000000..54de744776766ad2fca17fee35485bfa5acd69ab GIT binary patch literal 257 zcmV+c0sj7pP)= 2 +# +################################################# + +tde_create_handbook( DESTINATION khelpcenter/markup ) diff --git a/doc/tutorials/markup/Makefile.am b/doc/tutorials/markup/Makefile.am new file mode 100644 index 0000000..4169155 --- /dev/null +++ b/doc/tutorials/markup/Makefile.am @@ -0,0 +1,3 @@ +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/tutorials/markup/index.docbook b/doc/tutorials/markup/index.docbook new file mode 100644 index 0000000..fa84114 --- /dev/null +++ b/doc/tutorials/markup/index.docbook @@ -0,0 +1,5317 @@ + + + +]> + + + + +The &tde; DocBook Markup Guide + + + +LauriWatts +lauri@kde.org + +&tde-authors; + + + +2000200120022003 +Lauri Watts + + +&tde-copyright-date; +&tde-team; + + +&FDLNotice; + +&tde-release-date; +&tde-release-version; + + + +A reference guide to &tde; DocBook markup standards. +Please report any errors or omissions to +trinity-devel@lists.pearsoncomputing.net. + + + + +TDE +Docbook +Documentation +Authors + + + + + +General &tde; markup style guide + + + + +Format for readability, and content, not for a formatted document. + + +It is not your job or responsibility to make sure the final +documentation looks good. If you use appropriate markup tags for the +content of your documentation, the processing tools will ensure your +document looks good. Do not substitute an inappropriate DocBook &XML; +tag because you do not like the look of the correct tag. + + +You should use white space to make the DocBook source more readable to +the writer. Please do not indent unless it is absolutely necessary. + + + + + +Do what you can to ensure you turn in a valid +DocBook file. The reviewers will correct any DocBook errors you create, +but please try to reduce errors by checking your work before it is +turned in. If you have the &tde; tools installed, you can use the +command checkXML +index.docbook to check for syntax +errors. No result from checkXML is a good result - +it means there are no problems. + + + + + +Non-English words should be tagged with <foreignphrase +lang="de">Wort</foreignphrase>. + + + + + +Underlining and CAPITALIZING entire words are leftovers from the days of +typewriters. They are no longer appropriate for today's documents. + + + + + +Do not use quotation marks in your documentation. If you want a word to +appear within quotation marks, simply enclose it between quote tags. + + + +This software is provided <quote>as +is</quote>. + + + + + + +There are three different dashes that are commonly found +in documentation. + + + + +The hyphen combines two or more words into one. For example, +mother-in-law. The hyphen can be entered directly from +the keyboard. + + + + +The en-dash is used to seperate numbers/dates/&etc;. For example, +Sections 1–3 review basic concepts. The en-dash +can be encoded using ndash. + + + + +The em-dash is used to separate sentences, or to show that something is +missing. This is rarely used in technical documentation, but it can be +used to show that one sentence is interrupted by another. The em-dash +can be encoded using mdash. + + + + + + + +When trying to decide between an ordered and unordered list, simply ask +yourself the following question: Does the order of the listed +items matter? or If I change the order of the listed +items, does that change the meaning of the list?. If you answer +No to either question, then an unordered list is likely +the logical choice. + + + + + +All chapter and sectN tags must +have an id. The id must be in all lower case, and with +dashes separating words. For example, <sect1 +id="how-to-obtain-kapp">. + + + + + +All elements must have a full closing tag unless they are empty +elements. Empty elements must still be closed with a /. + + +Incorrect +Correct + +<para/Blah blah/ or <para>Blah +blah</> +<para>Blah blah</para> + + + + + + +No attribute minimization. + + +Incorrect +Correct + +attribute=value or +attribute='value' +attribute="value" + + + + + + +All entities must end with a semi-colon: + + + +Incorrect +Correct + +%parameterentity or +&generalentity +%parameterentity; or +&generalentity; + + + + + + +Element GIs (the first word in a tag) must be written in lower case +only. + + +Incorrect +Correct + +<MediaObject> or +<MEDIAOBJECT> +<mediaobject> + + + +Entities are also case sensitive, and will result in validation errors +if the case is wrong. + + + + + +Specify date and application's version in the format: + + + + <date>2000-12-31</date> + <releaseinfo>1.02.03</releaseinfo> + + + +The date is the date of the last +update. The releaseinfo always +matches the version number of the application that is described in the +documentation (if any). A translated version of a documentation always +has the same date and releaseinfo as the English original. Please +respect this, it is the only way to manage efficiently both the writing +and the translation processes. + + + + + +The list of entities for applications is maintained centrally. Entity +names are the application name completely in lower case. In case the +name you need does not exist yet, send a mail to +kde-docbook@kde.org to have it added. You may add it in +the prologue for validation purposes (in case it's new), but don't +forget to remove it when you submit the document, because there should +not be any extra entities defined in the document +prologue. + + + + + +For language-independent entities, use +kdelibs/kdoctools/customization/entities/general.entities +and for language-specific entities, use +kdelibs/kdoctools/customization/lang/user.entities. Try +to avoid clashes with existing &tde; entities. + + + + + +The en/user.entities file should be updated +keeping in mind that translation must be possible. Here is an example of +how this translation can be managed: + + + +Managing translatable entities + + +LMB is en entity which stands for +Left Mouse Button + + + +When translating to French for example, do not translate only the entity +contents, please also translate the entity name to BGS (or bgs), to reflect the change in the +initials: + + + <!ENTITY "LMB" "left mouse button"> becomes + <!ENTITY "BGS" "bouton gauche de la souris"> + + +Languages that decline nouns like German and Russian can use something +like the following: + + + + <!ENTITY "LMB" "linke Maustaste"> + <!ENTITY "LMBn" "linken Maustaste"> + + + + + + +If you feel that some elements don't make fine enough a distinction, +feel free to use the attribute role +(but please tell the DocBook team, as otherwise you may find your +document to be suddenly invalid). + + + + + +Use qandaset for +&FAQ;s, not an itemizedlist. Please split up a +&FAQ; into several chapters or sections if it gets big. +The &HTML; files get too big otherwise, which the users +may not like. + + + + + +Abbreviations and acronyms should be marked up as well. + + + +Use the DocBook tags abbrev and +acronym respectivly. + + + +Please keep them apart: acronyms are things like &GUI;, &tde;, +GPL, while abbreviations are things like &etc;, &ie;, +⪚. + + + +There are entities for the most common ones. + + + + + +Use glossterm or firstterm each time you introduce a +technically significant new word. + + + + + +Keep in mind that the $ sign is introduced by the shell, +and is not part of an environment variable's name: + + + + +ls +$TDEDIR is marked up +as +<userinput><command>ls</command> +<option>-l</option> +<parameter>$<envar>TDEDIR</envar></parameter> +</userinput> +export +$TDEDIR=/usr/local/tde +is marked up as: +<userinput> +<command>export</command> +<parameter>$<envar>TDEDIR</envar>=<filename> +/usr/local/tde</filename></parameter></userinput> + + + + + +Only use ulink for &URL;'s and not +for files, unlike A in +HTML. Don't use it for email addresses either, they +have their own element, email. + + + + + +The elements beginpage and bridgehead are disallowed and have been +removed from the &tde; customized DTD. (They are not +meant for new technical documentation.) revisionhistory has been removed also: we are +using SVN already. + + + + + + + + +Purpose of this document + + +The purpose of this document is to describe how markup has been standardized within +&tde; documentation only. + + + +This document is not to be considered more +authoritative than the DocBook documentation, including the O'Reilly +Duck book. However, there are places where the &tde; +DTD is more restrictive than, or just differs from, +the OASIS DTD, and these are noted +in this document. In these cases, follow the instructions here. + + + +Please read and make use of the other documentation available to you, +which is much more comprehensive. This document is not intended to be +more than a quick reference for &tde; authors, to clarify how the +DocBook &XML; elements are used within the &tde; Documentation. + + + +Other reference material + + +Please take a look at the following reference material, rather than +relying on this document to answer all your questions. + + + + +The Duck book + + +The complete DocBook SGML (and now +&XML;) reference. Available as a download in several +formats, so you can keep a copy on your hard drive for reference. Also +available for sale in hard copy - if you see yourself doing a lot of +DocBook Authoring, you definitely ought to consider buying it. + + + + + +The Crash +Course to Docbook + + +A non-&tde; specific crash course to marking up documentation. This is the +starting point for all &tde; documents, including the markup issues discussed +here. Note that the current version is written for +SGML, but the concepts are still correct for &XML;. + + + + + +The &tde; Documentation Template + + +Covers many things not mentioned here, including required and optional +chapters, the preferred way to mark up the prologue and bookinfo +sections, and how to deal with licensing and credits. It can be found +in kdelibs/kdoctools/template.docbook in CVS. + + + + + +DocBook-XML (in German) + +A very nice book, in German only unfortunately, but comes highly recommended. + + + + + + + + + + +The Prologue + + +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!-- Define an entity for your application if it is not part of TDE + CVS --> + <!ENTITY kmyapplication "<application>KMyApp</application>"> + <!ENTITY kappname "&kmyapplication;"><!-- replace kmyapplication here + do *not* replace kappname--> + <!ENTITY package "tde-module"><!-- tdebase, tdeadmin, etc. Leave + this unchanged if your + application is not maintained in TDE GIT --> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % English "INCLUDE"> <!-- ONLY If you are writing non-English + original documentation, change + the language here --> +]> + + + +In general, this needs minimal changing from the template. The items +you must change are the entities +kappname, package, and English. + + + +The entity kappname looks like it's redundant (as the +comment in the template notes), but it is important. This allows us to +use one global text in all documents, and still refer to the specific +application by its correct name. So it should be changed to refer to +this new entity, but this time you should only change the part in quotes +(&kmyapplication;) as follow: + + + +Setting up the global <quote>kappname</quote> entity + + +From: + +<!ENTITY kappname "&kmyapplication;" -- this only *seems* redundant --> + +To: + +<!ENTITY kappname "&kate;" -- this only *seems* redundant --> + + + + +In short: change any occurrence of kmyapplication +to the real name of your application. Do not use +kappname or kapp directly in a document +yourself. + +The entity package is used similarly. It allows +us to insert a single piece of boilerplate text into +every document, and have the correct package name inserted when the +document is compiled. Use the cvs module name, in lower case, ⪚ +tdeedu or tdebase. + +The entity addindex is a toggle. If +set to INCLUDE a document index will be automatically +generated. It is normally set instead to IGNORE, and should +not be changed unless you really do want to generate an index. You can find +out more about indexes in . + + +A &tde; User Manual Prolog + +Here is an example of a completely set up prolog, as it normally +looks. This is the prolog from the &amor; documentation + +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!ENTITY kappname "&amor;"> + <!ENTITY package "tdetoys"> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % English "INCLUDE"> +]> + + + + +The entity English should be changed to reflect your +language, if you are either writing original documentation in another +language, or you are translating a document. For &tde; the original +documentation should always be in English, so you should not need to change +this when writing. For informational purposes, the currently supported +languages are: + + + + + +Afrikaans + + + + +British-English + + + + +Bulgarian + + + + +Catalan + + + + +Czech + + + + +Danish + + + + +German + + + + +Greek + + + + +English + + + + +Spanish + + + + +Estonian + + + + +Finnish + + + + +Faroese + + + + +French + + + + +Hebrew + + + + +Hungarian + + + + +Indonesian + + + + +Italian + + + + +Japanese + + + + +Dutch + + + + +Norwegian (Note, this is only for compatibility, either Norwegian-Bokmal or +Norwegian-Nynorsk should be used in preference.) + + + + +Norwegian-Bokmal + + + + +Norwegian-Nynorsk + + + + +Polish + + + + +Portuguese + + + + +Brasilian-Portuguese + + + + +Romanian + + + + +Russian + + + + +Slovak + + + + +Slovenian + + + + +Serbian + + + + +Swedish + + + + +Turkish + + + + +Ukrainian + + + + +Walloon + + + + +Xhosa + + + + +Continental-Chinese + + + + +Traditional-Chinese + + + + + + +<sgmltag class="element">book</sgmltag> and the <sgmltag +class="element">bookinfo</sgmltag> section + + +The bookinfo section is most easily prepared +by copying the &tde; template. + + + + +book lang="&language" + + + + +Contains the entire document. Most important thing to remember is the lang attribute, which must contain exactly &language;, and must not be changed. To set the +language for the document, change the entity as described in the prologue section. + + + + + +bookinfo + + + + +Wraps the meta information – information about +the document, not about the application it is documenting. Required in +&tde; documentation. No attributes. + + + + + +authorgroup + + + + +Wraps the author information, and may also contain othercredit information. Required in &tde; +documentation. No attributes. + + + + + +author + + + + +Required element in the header section of all &tde; documentation. Use this +element only for the author(s) of the document. Other +contributers (developers, translators, and so on) should be credited in the +othercredit section. No attributes. + + + + + +personname + +Used to wrap a person's name. You can use this directly in the +text as well, but here it should be used to contain each author or +contributor name. + + + +firstname + + +The contributor's first name. + + + + + +othername + + +If the author normally uses more than a first and surname, you can add +further names here. + + + + + +surname + + +The author's surname. + + + + + +email + + +An email address for the maintainer of the document is required for +&tde; documentation. You do not have to use your primary private +address, and you may be able to arrange for someone else (the +developer perhaps) to receive the email regarding the document. In +any case, there must be an address for users and translators to +contact regarding errors and document bugs. + + +In previous versions of DocBook, email could not be used directly inside +author. Since DocBook XML V 4.2 +(used by &tde; for documents after &tde; 3.1.x), this is possible, +which simplifies this markup considerably. + + +In other contexts in the document, email is used to contain any email address, +and is not used inside the address +element. + + + + + +othercredit role="" + + + +Similary to author, this is a wrapper around +information describing other contributors to the document. Include here the +contributor's name and email address as you do for the author. See the template +for more details. + + + +The role attribute is required, and can +contain any one of the following: + + + + +Translator + + +Developer + + +Reviewer + + +Graphist + + +Musician + + + + +The othercredit element also includes the +contrib element. + + + + +contrib + + + +The role this contributor played in the document or application preparation. +This could contain something like: + + + + +Developer + + +Deutsche Übersetzung + + +Reviewer + + +Traduction française + + + + + + + + + +corpauthor + + + +This is used in very specific circumstances, where an organization +(⪚ The TDE Team) is being credited with authorship of +a document. Authors writing about applications should not use this +and should credit themselves. If you do find a need to use this, +please be sure to include a maintainer's name and email address in the +credits chapter of the document. + + + + + +copyright + + + +This is a wrapper for copyright information. copyright must contain these elements: + + + + +year + + +Add one year element for each year +in which the document was changed or added to. Don't put more than +one year in each tag, rather add more year elements, and use the 4 digit +YYYY format. + + + + + +holder + + +The usual full name of the copyright holder(s). If there is more +than one copyright holder (the document was previously maintained by +another person, or is written collaboratively), then add more copyright sections, rather than trying to +fit multiple names in the one section. + + + + + + +Copyright is automatically held by the author of the document, but the +copyright element is still required +for all &tde; documentation. None of the elements contained have any +attributes. + +Please do not add more names or years to +existing holder or year elements. Add more, if they are +required, or have multiple copyright sections. + + + + +legalnotice + + +This contains, of course, a legal notice. This is absolutely required for any +&tde; document. In the context of this section, it should contain the +&FDLNotice; entity, which inserts some information into +the document about the document's license (and not the +license of the application you are describing.) + + + + + +date + + +The date is very important. It is used not only by +scripts for automatic processing of documentation, but is also central +to revision control and co-ordination of translations. You must change +the date if you have changed the original document, +and you must not change the date if you are a +translator. The format of the date is very important. It +must be in the ISO, with +literal delimiters, in the form +yyyy-mm-dd. Please be extremely careful about this, +and triple check it before you send in the document. + + + + + +releaseinfo + + +This should match exactly the version of the +application you are documenting. It should +normally conform to the format X.x.xx (where X is a major version +number and x are minor version numbers, however, you no longer have to +pad the content to this length. That is to say, if the application has +released version 1.4, you may write +<releaseinfo>1.4</releaseinfo>, and you +do not need to make it +<releaseinfo>1.04.00</releaseinfo> +This is not the version of the document. +There are no attributes, and this element is required in &tde; +documentation. + + + + +abstract + + +In &tde; Documentation, the abstract is required. It should be a short +one- or two-sentence summary of the document. The abstract is not the +place to put version or contact information, but it should say something +about the application and its purpose. For example KFoo is a +small fast network enabled foo generator, suitable for both beginner and +advanced foo users.. + +The abstract is your chance to sum up the application in a small +paragraph — in &khelpcenter; it shows up on the first page as +your document is selected, and the abstract frequently shows up in the +summary of your document in web searches. A short overview of the +application you are writing about is very valuable in this situation, +This is the KFoo handbook and describes KFoo 1.2. on +its own, is not. + + + + +keywordset + + +A wrapper for a set of keywords suitable for search engines. Required +for &tde; Documentation, and there are no attributes. The keywordset should contain several +keywords. + + + + + +keyword + + +Add one keyword inside the keywordset for each search term. You must +include at a minimum the terms TDE, the name of the +application you are documenting, and the name of the package it is found +in, for example tdegames. The keywords should be in +order from most general first (that is, TDE) through +less general, to the most specific. Add two or three more relevant words +that people might search with, ⪚, for the application &kwrite; you +might add editor and text. This is +required for &tde; Documentation, and there are no attributes. + + + + +<!-- TRANS:ROLES_OF_TRANSLATORS +--> + + +This line is specific to &tde; documentation. Although it's a comment, +it is absolutely required in documents. It is +used by the translation system as a placeholder for the translation +teams to add their own role info. Translators should add more othercredit sections here as appropriate. + + + + + + +The bookinfo section from the &tde; template + +<bookinfo> +<title>The &kmyapplication; Handbook</title> + +<authorgroup> +<author> +<!-- This is just put in as an example. For real documentation, please + define a general entity in entities/contributor.entities, e.g. +<!ENTITY George.N.Ugnacious "<personname><firstname>George</firstname><othername>N.</othername><surname>Ugnacious</surname></personname>"> +<!ENTITY George.N.Ugnacious.mail "<email>gnu@tde.org</email>"> +and use `&George.N.Ugnacious; &George.N.Ugnacious.mail;' in the author element. + --> +<personname> +<firstname>George</firstname> +<othername>N.</othername> +<surname>Ugnacious</surname> +</personname> +<email>gnu@tde.org</email> +</author> +</authorgroup> + +<!-- TRANS:ROLES_OF_TRANSLATORS --> + +<copyright> +<year>2002</year> +<holder>George N. Ugnacious</holder> +</copyright> +<!-- Translators: put here the copyright notice of the translation --> +<!-- Put here the FDL notice. Read the explanation in fdl-notice.docbook + and in the FDL itself on how to use it. --> +<legalnotice>&FDLNotice;</legalnotice> + +<!-- Date and version information of the documentation +Don't forget to include this last date and this last revision number, we +need them for translation coordination ! +Please respect the format of the date (YYYY-MM-DD) and of the version +(V.MM.LL), it could be used by automation scripts. +Do NOT change these in the translation. --> + +<date>2003-01-10</date> +<releaseinfo>1.1.</releaseinfo> + +<!-- Abstract about this handbook --> + +<abstract> +<para> +&kmyapplication; is an application specially designed to do nothing you would +ever want. +</para> +</abstract> + +<!-- This is a set of Keywords for indexing by search engines. +Please at least include TDE, the TDE package it is in, the name + of your application, and a few relevant keywords. --> + +<keywordset> +<keyword>TDE</keyword> +<keyword>tdeutils</keyword> +<keyword>Kapp</keyword> +<keyword>nothing</keyword> +<keyword>nothing else</keyword> +</keywordset> + +</bookinfo> + + + + + + +Chapters and Sections + + + +chapter +id="" + + +Use chapters to break up the document into smaller chunks. A chapter +break should occur when a major subject change happens. Use sections +within the chapter when the subject changes, but you are still +discussing a particular aspect of a larger subject. + + + +For example, going from discussing how to use the application, to how to +configure the application would be worthy of a new chapter. Moving from +discussing how to specifically configure the application on SuSE, to how +to specifically configure the application on &RedHat;, would be a new +section in a larger Configuration chapter. + + + +Chapters must have an id. This is +the only attribute used in &tde; documentation. For &tde; Documents, +this id must be in lower case, and with a hyphen (-) to separate words. +Please don't use spaces, underscores, or run the words together. For +HTML generation, the chapter id and most sect1 id's are used to name the separate +HTML pages, so take care to make them sensible and +descriptive. For translators, these id's should be translated, but you +will need to take care to also translate references to the id's in +link and xref elements in other parts of the document. + + + + + + +title + + +Titles are used in many places, but the most common is the Chapter and +Section headings. Make sure to use sensible titles, as these will also +be that chapter's (or section's) entry in the table of contents, so people +will rely on these to find the part of the document they are interested +in. + + + + + +sect1 id="", +sect2, sect3, sect4, sect5 + + + +Use sections to break chapters up into smaller pieces. Use similar +criteria on where to divide them as you would for chapters. + + + +Sections require a title. Sections +are nested according to the number - a sect2 can contain any number of sect3, which can contain sect4, but a sect2 can't directly contain a sect4. + + + +sect1 requires an id attribute, and +you can use id's on the other section tags if you want to later link +directly to them from other parts of the document. id is the only attribute used in &tde; +Documentation. + + + + + +sect1info, +sect2info, sect3info, sect4info, sect5info + +The section info elements are rarely used in &tde; Documentation. +They are appropriate for documents where some smaller sections are +contributed by third parties, or where the document covers multiple +applications. The contents are more or less the same as those of the +bookinfo section, although they +tend to be briefer. +Please ensure if you use these elements that you add the +translation placeholder comments as you do in the prolog. + + + + + +appendix + + +The standard installation instructions for all applications are +contained in an appendix, and are +normally required for &tde; documents. Although the installation +instructions as found in the template are reasonably complete, and +need no customization for most applications, authors are very strongly +encouraged to expand on them. For example, links to web pages, where +to find libraries, plugins, screenshots of the application in a +particular configuration, or any other information you can think of. + + +If the application is only distributed with &tde;, there is +little use in repeating the same installation instructions for every +manual. You may leave it out entirely, unless you have further +information to add. + + +For other purposes, appendices are used infrequently in &tde; +Documentation. An appendix can be found, for example, in the &kppp; +document, containing such things as Hayes Modem commands. Only use an +appendix if you think it's very necessary. In most cases, the +information it would contain would be better moved to the main document. +In the example of &kppp;, this information is vital to a few people, but +extremely uninteresting to the majority, so it was placed in an +appendix. + + + + + + + + +The linking elements + + + +link +linkend="" + + + +The most common link. Use this to turn a word or phrase into a link to +another part of the document. linkend is the only attribute we use. + + + + + +ulink url="" + +A link that refers to a document using it's +URI. Use this for websites and ftp sites, but not +for email addresses, which have their own +specific tag. Please do not use this to link to +other documents on the local system. + + + + + + +anchor id=""/ + + +Marks a place in the document, which you can use to link to. Note that +the id attribute on any other +element where it is valid, will automatically generate an +HTML anchor in generated HTML, so +you do not need to duplicate these. Use anchors only when you need to +jump into the middle of a longer page, for example, to a particular menu +item, or to a particular option in a preference dialog. + + + +anchor is an empty element, and must +be closed with a /. + + + + + + +xref +linkend="" + + +A cross reference to another part of the document. Use this when you +want to refer to the section without the name. This is one of very few +unclosed elements allowed. linkend +is the only attribute we currently use. + + + +xref is an empty element, and must +be closed with a /. + + + + + + + +email + + +Use this to enclose an email address. Don't add mailto: +to the email address, and don't use ulink +url="" for email addresses. No attributes required. + + + + + + + + + +Lists + + + +listitem + + +listitem is the main building block +of almost all the lists. It should always contain some other markup, +usually a para + + + + + +orderedlist + + +Use this type of list when the order of the items matters, but they are +not a set of steps that are carried out to achieve something. A good +example is a list of things in order of importance. + + + + + +itemizedlist + + +Use an itemized list when the order of the items is not +important. + + + + + +variablelist + + +A list that has two sections for each entry. Examples: A menu item, and +what the menu item does, An action, and its result, or a term and its +definition. This is a very common type of list. (Almost this entire +document is composed of variable lists.) + + +variablelist contains the following +elements: + + + + +varlistentry + + +A varlistentry is a wrapper around +each pair in the variable list. + + + + + +term + + +To reuse the above examples, the term for each pair would be the menu item you +are describing, the action, or the term you are defining. You can use +the id attribute for this element, +which is quite convenient in long lists such as a menu reference, +enabling you to link directly to a particular menu item from another +part of the document. + + + + + +listitem + + +As described above the listitem is +used inside a varlistentry to hold +the second part of the pair: The result of choosing that menu item, for +example, the consequences of an action, or the definition of the term. + + + + + + + + +procedure + + +Use a procedure list when you are listing a sequence of steps which are +performed in a particular order. + + +A procedure contains only one tag: + + + +step + + +A step is one of the sequence of events that make up a +procedure. + + + + + +substeps + +A step can contain substeps + + + + + + + + +simplelist + + +A simple list is just that - a simple list, with no formatting +required. A simple list can contain only one type of element: + + + +member + + +Members of a simple list. + + + + + + + + + +segmentedlist + + +A Segmented list is a very particular type of list. Use +sparingly, as it's very difficult to get these right, and most content +appropriate for a segmented list could just as well fit the table model. + + + +A Segmented List + + +<segmentedlist> +<segtitle>Name</segtitle> +<segtitle>Occupation</segtitle> +<segtitle>Favorite Food</segtitle> +<seglistitem> +<seg>Tux</seg> +<seg>Linux Mascot</seg> +<seg>Herring</seg> +</seglistitem> +<seglistitem> +<seg>Konqui</seg> +<seg>The TDE Dragon</seg> +<seg>Gnomes</seg> +</seglistitem> +</segmentedlist> + +Name +Occupation +Favorite Food + +Tux +Linux Mascot +Herring + +Konqui +The TDE Dragon +Gnomes + + +The segmented list contains the following elements: + + + + +segtitle + + +The title each segment will have + + + + + +seglistitem + + +A set of entries in the list + + + + + +seg + + +The contents of the entries in the list. In each +seglistitem there is one +seg for each +segtitle. + + + + + + + + + + + +Tables + + + + +informaltable + + +This is the table type used most in &tde; Documentation. Please be very +sure that what you are marking up as a table, is actually tabular data, +as in many cases a variablelist is +more appropriate. Please do not use any of the presentation attributes +to make tables look nice. The only attribute currently +allowed in &tde; Documents is pgwide. + + + +An informaltable must contain a +tgroup cols="" entry. Informal +tables have no specific title, if you wish the table to be titled and to +have an entry in the table of contents, you should use table. Do +not use any attributes other than pgwide on tables or informal tables for +&tde; documentation. + + + + + +table + + +A formal table with a title. Tables will have their own separate entry +in the table of contents. Other than the addition of a title, they are +marked up the same as an informaltable. + + + + + +tgroup +cols="" + + +A tgroup is a required element in a +table. The cols attribute is +required, and should be completed with the number of columns the table +is to hold. No other attributes used in &tde; Documentation. + + + +A tgroup must contain a tbody + + + + + +tbody + + +A tbody is a required element in a +table. There are no attributes. The tbody contains rows. + + + + + +row + + +A row corresponds directly with the +rows of the table. Rows contain entry tags, one for each column in the table, +as specified by the cols attribute +on the tgroup tag. + + + + + +entry + + +The entry is the basic building block of a table. Each entry corresponds +to one data cell in the table. There must be as many +entry tags in each row as the +cols attribute on the tgroup tag. +There are no attributes used in &tde; Documentation. + + + + + +thead + + +thead can be used to create a +heading row for the table. It must appear before the tbody element, and should normally contain one +row and as many entry elements as the rest of the table. + + + + + +tfoot + +tfoot is not currently used in +&tde; Documentation. If you want to use it, please see the Duck book +for information. + + + + + + +An <sgmltag class="starttag">informaltable</sgmltag> +template + + +<informaltable> +<tgroup cols="2"> +<tbody> +<row> +<entry></entry> +<entry></entry> +</row> +</tbody> +</tgroup> +</informaltable> + + + + + +A <sgmltag class="starttag">table</sgmltag> template + + +<table> +<title></title> +<tgroup cols="2"> +<tbody> +<row> +<entry></entry> +<entry></entry> +</row> +</tbody> +</tgroup> +</table> + + + + + + + +The &GUI; elements, menus, toolbars and +shortcuts. + + + + +action + + +The result of a user action. This does not need to be a complete +sentence, or even more than a single word. For example, This +button <action>closes the dialog</action>. The main +place you will find this in &tde; Documentation is in the Menu and +Command reference chapters of the manuals. + + + + + +guibutton + + +The text on a button that you click on. Icons, Radio buttons and check +boxes are not considered buttons in this sense. + + + + + +guiicon + + +The name or description of an icon. + + + + + +guilabel + + +The text of anything that is labelled on screen, and isn't a button, +icon, menu, or menu item. For example, the name of a dialog box, the +name of a tab in that dialog box, and the name of a label by a checkbox. + +Take care that the text exactly matches the label on screen. If +it has a : on the dialog box, put the +: into your documentation. Match the +capitalization. There is a script in the tde-i18n module called +check-gui-texts which you can use to help check +that your text matches exactly what is in the application. During +translation, the translators can use this script to generate +translations from their translations of the &GUI; itself, but this +will only work if the English text matches precisely. + + + + +guimenu + + +The top level name of a menu (that is, the name you can see on the menu +bar when the menu isn't open). + + + + + +guimenuitem + + +The final item you select on the menu, that actually performs an action. + + + + + +guisubmenu + + +A submenu. That is, a menu which has items both above and below it in +the hierarchy. + + + + + +keycap + + +A keycap is a key as it is labelled on your keyboard. +Home is a keycap on a standard English keyboard. +Alt Gr is a standard key on many European keyboards. + + + + + +keycode + + +The internal identifier for a key on the keyboard. Used very +infrequently, but you may find need for it, for example when describing +entries in rc files. + + + + + +keysym + + +Right arrow is the keysym for the +keycap that looks like +->. Please note this is a &tde; specific use of +keysym, and does not precisely +follow the examples in the Duck Book. + + + + + +menuchoice + + +A menuchoice describes a menu entry. You should use menuchoice anywhere you are describing how +to reach a menu item. In normal text, there are no particular +requirements. In a menu reference, the menuchoice should also contain a shortcut element describing the keyboard +shortcut, and the contents should also be marked up with accel as appropriate. + + + + + +shortcut + + +A key combination that is a shortcut for a menu item. This is +only used inside menuchoice and contains keycombo or keycap that is defined as the keyboard +shortcut in the menu. In the markup, it appears before the actual menu +entries inside the menuchoice You do +not need to describe the shortcut every time the menu item is mentioned +in the text, although it may be appropriate to do so on some occasions. + + + + + +mousebutton + + +The normal name of a mouse button. It will be normally be one +of: + + + +<mousebutton>left</mousebutton> or +the entity LMB + + + + +<mousebutton>middle</mousebutton> or +the entity MMB + + + + +<mousebutton>right</mousebutton> or +the entity RMB. + + + + +<mousebutton>wheel</mousebutton> + + + + +Wheel is used only in specific instructions for applications that +support it, of course. + + +Use the entities where possible, they are a lot less typing and +are simple to remember (which is why we have provided them.) If you are +translating, check with your team leader, as the entities above are +not translated, but you may have your own language +specific ones to use in their place. + + + + + + +keycombo +action="" + + +A keycombo is a sequence or combination of keypresses that are performed +together. A keycombo can contain keycap, keysym or mousebutton, or +any combination of these, in any order. It is normal to +have them in the order modifier, +Alpha-numeric, Mouse. That is, +&Ctrl;A, not +A&Ctrl;, unless pressing +A then &Ctrl; actually is the shortcut. + + + +Keycombo requires an action +attribute, describing exactly how the keys (or mouse buttons) are +combined. The choices are: + + + + + +Click + + + + + +Double-Click + + + + +Other + + + + +Press + + + + +Seq + + + + +Simul + + + + + +You will most likely need to use Seq +(for a sequence of keys that are pressed one after the other), or +Simul for a combination of keys that +are pressed at the same time. + + + + + +accel + + +The accelerator key that can be used to access a GUI +menu without a mouse. This is indicated in the menu by an underlined +letter. Although we previously used this in the menu references, we +have since decided not to, the maintenance is too high, and it causes +an enormous amount of work during translation. + + + + + + + +An example from a menu reference entry + + + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl; +<keycap>C</keycap></keycombo> +</shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Copy</guimenuitem> +</menuchoice></term> +<listitem><para><action>Copy the selected text</action> to the +clipboard</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul">&Ctrl; +<keycap>V</keycap> +</keycombo></shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Paste</guimenuitem> +</menuchoice></term> +<listitem><para><action>Paste</action> the contents of +the clipboard at the cursor.</para></listitem> +</varlistentry> + + + + +Please note, this is very complicated markup, and until you have +written a few it's very hard to follow, but it does get much easier with +practise! Although indenting is discouraged in general, this is one +place where you might want to use some indenting and white space to make +it clearer while writing, at least when you are beginning. There are +also no rules as to when you must start a new line for a new element, so +format the markup to suit your own taste while you are writing, if that +makes it easier for you to follow. + + + + + + +Describing actions and commands + + + + +replaceable + + +Use this for placeholder or sample text, that a user would not +actually type, but would instead replace with the correct text for +their environment. For example, Edit the file +<filename><replaceable>/usr/local/foo/bar</replaceable></filename>, +because it may already be established that /usr/local is only the default location +of this file, and the user may have it installed to ⪚ /opt/ instead. + + + + + +application + + +Use this to mark up the name of any software program mentioned in the +text. Don't use this to mark up the actual command issued to execute +the application. For example, application>Kate</application is the +name of the editor, but command>kate</command is the name of +the command that starts the Kate +application. + + +All &tde; applications, and several non-&tde; but very common +applications, are provided as entities. + + + + +For the &tde; applications, using the entities will save you much +typing, and will ensure that applications are always referred to with +their correct name across all documentation. The entity is always the +application's executable name, in lower case, ⪚ kcontrol, konqueror or kmail. + + + +For non-&tde; applications, one of the major reasons to use the entities +is that there are legal implications, so far as we are required to +acknowledge trademarks and copyrights held by others outside our +organisation. You will find in a +list containing a list of the more common non-&tde; application +entities. + + + + + +interface + + +Catch all element for gui interface items that do not have a more +specific tag. You can use this to markup things like the View +pane in &khelpcenter;, or the Board in +&kjumpingcube;. + + + + + +userinput + + +Any text that the user must type, including +commands and data entry. + + + + + +screen + + +Used to represent the computer screen (usually to represent a terminal +or console.) Text contained in screen is considered to be literal text — +line breaks and white space are honored and it will be rendered with a +mono-spaced font. Don't use screen when what you really want is an +example, or an informal example. + + + + + +command + + +Text the user enters to instruct the computer or an application +to do something. ls + is a command (it's also userinput, +and has options.) /join #tde +in an irc client is a command (and again, is +userinput.) + + + +Commands are not userinput when you +are not expecting the user to actually type them, for example in the +sentence The output from the ls command should +show you..., the text ls is a command, but is not +userinput in this context. + + + +Applications not marked up with the application tag are also considered commands, +for example, gcc, automake and +autoconf. + + + + + +prompt + + +The prompt at which a user types input. For most &tde; +Documentation, this has been standardised as +promptpercntprompt (which is the % character). + + + + + +option + +An optional parameter to a command. Since we write about &UNIX; +platforms, an option on the commandline is almost always indicated by a +-, but there are exceptions (⪚, +tar +filename.tar.gz or +ps , which +are marked up as +<userinput><command>tar</command> +<option>zxvf</option> +<replaceable>filename.tar.gz</replaceable></userinput> +and <userinput><command>ps</command> +<option>ax</option></userinput> respectively. + + + + + +envar + + +An environment variable. Note that the variable indicator (usually $ +for &UNIX;) is not part of the name of the environment variable, so it +is correct to do this: +$<envar>TDEDIR</envar>. There are no +attributes in use in &tde; Documentation. + + + + + +errorcode + + +A (usually numeric, but not always) error +code. SIGSEGV is an errorcode, as is +404 as you might receive when you are web +browsing. + + + + + +errorname + + +The actual text of an error message - to reuse the +404 example, the errorname might be Page not +found. + + + + + +errortype + + +The type of error, ⪚ fatal +or recoverable. + + + + + +filename + + +Use filename for all occurrences of +file names including: + + + + +Directory names — with the attribute class="directory" + + + + +Paths + + + + +File names + + + + +File name placeholders (which should also be tagged with +replaceable + + + + + +Do not use filename for file +fragments or extensions (&ie; *.tgz +which should instead be marked up as literal role="extension". + + + + + +symbol + + +Symbols are things that are replaced by the computer when they are +processed. It's difficult to say when things are a symbol and when they +are not - if there is a more specific element to use (⪚ envar or constant then you should use that instead. + + + + + + + + + +Questions and Answers + + + +qandaset + + +A set of questions and answers, suitable for a +&FAQ;. qandaset must +contain qandaentry. + + + + + +qandaentry + + +Each question and answer pair is a qandaentry. + + + + + +question + + +The question being asked. It must be inside a qandaentry, and +it must have a matching answer. + + + + + +answer + + +The answer to the matching question in the same qandaset. + + + + + + + +<sgmltag class="starttag">qandaset</sgmltag> Template + +<qandaset> +<qandaentry> +<question> +</question> +<answer> +</answer> +</qandaentry> +</qandaset> + + + + + + +Images and Examples + + + + +screenshot + + +Wrapper around screenshots. Use this when you are including a +screenshot in your document. + + + + + + +screeninfo + + +Screeninfo is a description of the screenshot. It's common (but not +required) to reuse this text in the textobject element, as it saves +translation time. + + + + + +mediaobject and inlinemediaobject + + +Use inlinemediaobject to insert an +inline image (that is, one that is inside a paragraph of text, or is the +only item in a table entry. Use mediaobject for all other images. If the +image is a screenshot, the mediaobject should be wrapped with a +screenshot element. mediaobjects +contain the following items: + + + +imageobject + + +Imageobject contains information about one specific image. DocBook +allows you to add more than one imageobject, in order to provide +alternatives if the user is unable to see the preferred image. We don't +currently use this functionality in &tde; Documentation, but may do at +some time in the future. + + + + + +imagedata fileref="" +format="" + + +This element holds the actual image reference. The fileref +indicates the location of the image. You should always keep images in the same +directory as the document itself, so you need only put the filename into the +fileref attribute. The format indicates the type of image you are including. +For &tde; this should be PNG. Do +not use gif format images for &tde; documents. + + +This is one of few empty elements in use in &tde; +Documentation. This means there is no </imagedata>, but you +should always close the element as shown above, +with a final /. + + +Keep the images in the same directory as your +index.docbook, don't create a separate directory to +store them in. + + + + + +textobject + + +Encloses the text part of a screenshot, which for &tde; Documentation +means it contains a phrase element. + + + + + +phrase + + +A short descriptive phrase about the image contents, this element is +contained in the textobject element. + + + + + +caption + + +If you want the image to have a caption when displayed, you can add +this. It's not required for &tde; documents, but recommended, +especially if there are several images near each other and there could +be confusion as to which you are referring in the text. + + + + + + + + + +informalexample + + +Use this element to enclose any informal examples you use in your +document. There are no attributes. An informal example can contain +almost any markup, so feel free to use them liberally. They should +generally not be part of a paragraph. + + + + + +example + + +An example is a more formal example, which has a title and an entry in +the table of contents. Use sparingly, because having a hundred examples +listed in the contents of a 5 page document lessens their usefulness. +However, don't hesitate to use when you think it's necessary. + + +I've used them in this document to make it easy to quickly go to the +small template examples for complex markup, because you +can find them directly from the table of contents. Less difficult +examples in this document have informalexample instead. Use your best +judgement. As with informalexample, +they can contain almost any markup. + + + + + + + +A screenshot example + + + +<screenshot> +<screeninfo>An example image</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="example.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>An example image</phrase> +</textobject> +</mediaobject> +</screenshot> + + + + + + +General markup (not covered elsewhere) + + + +abbrev + + +Abbreviations are shortened forms of longer words. + + + +Abbreviations are not normally pronounced in speech. Examples are ⪚ +and &ie;. This is a &tde; specific distinction, please stick to +it. + + + + + +acronym + + +Acronyms are shortened forms of words or phrases, often made up of the +initials of the words in a phrase. Acronyms are normally pronounced in +speech as well as written. Examples are &GUI; and +&tde;. As with abbrev, this is a +&tde; specific distinction. + + + + + + +attribution + + +If you use quote or blockquote, the source of the quote (that is, +who you are quoting) should be cited with this tag. + + + + + +blockquote + + +Use this when you want to quote a passage of text that should be set off +from the main text, for example, an entire paragraph from a book or +other source. Use quote to quote a +passage of text that is not to be set off, for example a short sentence +or comment from another person. Use both of them as little as you can, +there are copyright issues to quoting from other works inside &tde; +Documentation. + + + + + +emphasis + + +Use this to emphasise text. Don't use it to mark up file names, +commands, or anything else. Use it where you might type in all caps in +an email, for emphasis of one word or short phrase, and try not to use +it too much. Emphasis loses it's power when over used. + + + + + +computerouput + + +Text the user can see on the computer screen. For example, a +listing of a directory as produced after the command +ls would be computeroutput. + + + + + +epigraph + + +A short quote or saying at, sometimes used at the beginning of a chapter +as an introduction. Use sparingly, no attributes used by &tde;. + + + + + +equation + + +Equation is used if you need to mark up a mathematical equation. You +are unlikely to need to use this in &tde; Documents. + + + + + +hardware + + +Used when referring to a piece of computer hardware, ⪚ +Floppy Drive or Monitor. + + + + + +lineannotation + + +A comment, for example in a programlisting. This is +not for comments contained in the text, it is for +comments by the author (you) about the text. + + + + + +literal + + +In &tde; Documentation, this is markup of last resort (or the +least of all evils) Use it only for things that must be marked +up, but have no appropriate tag, and preferably only for the following +things (already decided on:) + + + + +literal +role="extension">*.tar.gz</literal + + + + + + + +literallayout + + +Use very sparingly, when it is absolutely vital that some text is +presented exactly as it appears, including white space and line breaks. +There is almost always a better tag to use than this (screen and +computeroutput together, or even a screenshot). + + + + + +markup + + +Use to wrap markup examples, for text that should be represented +literally. Examples are this document, and documents that have +HTML markup included literally in them. Other than +meta-documentation like this, you probably won't have much need for +markup. + + + + + +optional + + +Optional information, usually in user input. Not used to date in &tde; +Documentation, but it may be appropriate in some circumstances. + + + + + +para + + +A paragraph. This is the most common tag. You do not need to enclose +lists, tables, or other markup with para. Sometimes however, you might want to do +so, especially with screen and some +types of lists, when they actually are still part of the current +paragraph. + + + + + +quote + + +Use when you are quoting something or someone, inside a sentence. Also +use if you want a word or phrase to be enclosed in quotes +like this. + + + + + +trademark +class="" + + +Used to denote that a word is a trademark. There is the optional +attribute class which should +contain one of the following, if appropriate: + + +copyright +registered +service +trade + + +If there is no class="" attribute, +trade is assumed. + + +We have provided entities, marked up appropriately, for very commonly +met trademarks, including &Qt; (Qt), &UNIX; (UNIX), &Linux; (Linux) and many more. + + + + + +sgmltag + + +An SGML tag. This includes &XML; and &XHTML; tags. +Use this for marking up individual components, but use markup when you need to display a block of +markup. + + +sgmltag will generate the correct +markup characters for you, based on the class attribute. + + + +Attribute values available: + + + + + +attvalue, for the contents of +an attribute. + + + + +attribute, for attributes. + + + + +element, for element names. + + + + +endtag, for closing tags (⪚ +para. + + + + +emptytag, for tags which are +empty, such as br in +&XHTML;. + + + + +genentity, for markup up general +entities. For example, nbsp in +&XHTML;. + + + + +numcharref, to mark up a numbered +character reference. nbsp, for +example, could also be referred to as 160. + + + + +paramentity +. You are unlikely to need this +for any &tde; documentation. + + + + +pi +. Note this is an +SGML PI, not an &XML; one. You +are very unlikely to need this for any &tde; documentation. + + + + +xmlpi. An &XML; processing +instruction, such as + + + + +starttag. An opening tag, such as +para. Most of this document is +marked up this way. + + + + +sgmlcomment. + + + + + + + +superscript + + +Superscript as in x2. Unlikely to be +required in most &tde; Documentation. + + + + + +msgtext + + +The actual text of an informational message. Use errorname for error +messages. + + + + + +subscript +Used to create things like H2O. +Unlikely to be found in most &tde; Documents. + + + + + +foreignphrase +lang="" + + +Use this any time you need to use text in a language different than the +main language of the document. This should be rare, but may occur +especially in credits information. The lang attribute should contain the normal two +letter designation of the language. Please be careful with these, the +Country and Language codes are +sometimes different, ⪚ se is the country code for +Sweden, but the language code is sv. Using +uk for British English would give you possibly unexpected +results, as this is actually the language code for Ukrainian. + + + + + + + + +Admonitions: Tips, hints, and Warnings. + + +Admonitions are set off from the main body of the text. Use these +sparingly, as they disturb the flow of the writing, but don't be afraid +to use them where necessary. Just make sure they +are necessary when you do use them. + + + +We have settled on a preliminary order of importance for these elements, +which differs from that explained in the Duck Book. Note that this +particular order is for &tde; Documentation only, and use your own +judgement which is the most appropriate element if your situation +differs from those outlined. + + + + + +warning + + +Use warning when data loss could occur if you follow the procedure being +described. + + + + +caution + + +A note of caution. Use this for example when the reader may lose easily +recovered or replaceable information (⪚ user settings), or when they +could cause data loss if they don't correctly follow the procedure being +outlined. + + + + +important + + +When there is no danger of data loss, but you wish to make clear to the +reader a consequence that isn't immediately obvious (⪚ when changing +the font for one instance of a program also changes the default setting, +and this isn't clear from the &GUI;.) + + + + +note + + +Information the user should be aware of, but is peripheral to the actual +task being described. + + + + + +tip + + +When you're giving a hint to make things easier or more productive for +the reader. + + + + + +footnote +id="" + + +Use very sparingly for things that really are footnotes. An example +might be to note that the situation being described will be changing at +some currently unknown future time. Most footnotes would better be +marked up as notes, or tips. + + + + +footnoteref +linkend="" + + +You can refer to a footnote more than once, by using this element to +refer to it's unique id. The footnote does not need to be in the same +chapter. Use this very sparingly. + + + + + + + +The synopsis elements + + + + +cmdsynopsis + + + + + + + +How to markup a command synopsis + + +<cmdsynopsis> +<command>more</command> +<group choice="opt"><option>-d</option> +<option>l</option><option>f</option> +<option>p</option><option>c</option> +<option>s</option><option>u</option> +</group> +<arg>-num</arg> +<arg>+/ pattern</arg> +<arg>+ linenum</arg> +<arg rep="repeat"><replaceable>file</replaceable></arg> +</cmdsynopsis> + + +This should generate: + + +more + + + + +-num ++/ pattern ++ linenum +file + + + + +There are several very nice examples in the Duck book at www.docbook.org + + + + + + + +funcsynopsis + + + +How to markup a function synopsis + + + +<funcsynopsis> +<funcprototype> +<funcdef>void <function>setFile</function></funcdef> +<paramdef>QString <parameter>file</parameter></paramdef> +</funcprototype> +</funcsynopsis> + +<funcsynopsis> +<funcprototype> +<funcdef>void <function>setAutoResize</function></funcdef> +<paramdef>bool <parameter><replaceable>val</replaceable></parameter></paramdef> +</funcprototype> +</funcsynopsis> + +<funcsynopsis> +<funcprototype> +<funcdef>QString <function>getVideoCodec</function></funcdef><void/> +</funcprototype> +</funcsynopsis> + + + + +These would generate the following, respectively. + + + + +void setFileQString file + + + + + +void setAutoResizebool val + + + + + +QString getVideoCodec + + + + + +A function synopsis can contain the following: + + + +funcprototype Contains +a prototype of the function. It can contain void, varargs, paramdef or most commonly, a funcdef which actually defines the +function. + + + +funcdef +A function and it's return type. + + + +funcparams +Contains the list of parameters for the +function. + + +paramdef +Information about the parameters of a +function. + + + +void +An empty element in a function indicating there are no +arguments. + + +varargs +An empty element in a function indicating there are multiple +arguments, without specifically listing them. This is generally represented +with an ellipsis (...). For example int +max(...); + + + +funcsynopsisinfo +Not used in &tde; documentation. + + + + + + + +arg +Used inside cmdsynopsis. Since most &tde; +applications are &GUI; only, you won't see this very often. See the entry +for cmdsynopsis for a full explanation and +example. + +group +Group +sbr +sbr +synopfragment +synopfragment + + + +modifier +A modifier modifies a class, field, or method synopsis. +Examples are the words public, private or +virtual + + + +fieldsynopsis +A field synopsis. + + + + + + + +Markup for programming + + +For formally marking up code examples or making a synopsis, you should +study the Duck Book and the Synopsis +chapter. The elements described below are mainly for marking up of +pieces of source code that appear in the running text. Remember that +&tde; and &tde; applications are written almost exclusively in C++, so +our useage may differ in places from the examples in the Duck book, +which may be describing other programming languages. + + + +To Developers reading this, remember most of the authors who may be +documenting your work are unfamiliar with source code, and many of them +like it that way. Therefore, the explanations here are more concerned +with how to tell things apart than what they are for, and may make you +cringe. + + +To everyone reading this, this section is very much under +construction so to speak. If you already need to use this markup, you +can ask questions on the tde-docbook mailing list, which is the most +likely place to get correct and up to date answers. + + + +classname + + +Used to identify the name of a class in a programming language. In +&tde; Documentation, you won't see this much in the user documentation, +except for those applications which contain an API reference +chapter, and occasionally in others. You will find it used a lot in the +TDevelop documentation. + + + +For non-programmers, as we're almost exclusively discussing &tde; +applications written in C++ and using &Qt;, classnames are fairly easy +to distinguish: They start with a capital Q or K, and are usually one +word only, in the form of KApplication or +QListBox. + + + + + +function, +methodname + + +A function or subroutine. In C++, a function generally +looks something like this: foo();. The semi-colon +may not always be present and there may or may not be content inside the +braces. + + + +If you see things that have the form +Kfoo::bar() these are not just functions, but +also methods, so you would use the methodname for these. + + + +Constructors are methods where the parts before and after the :: are the +same, ⪚ KFoo::Kfoo().Destructors look like +Constructors, but have a ~ after the :: ⪚ +Kfoo::~Kfoo(). The same things apply as with +functions and methods: there may or may not be a ; at the end, and there +may or may not be content inside the braces of a constructor (there is +never content for a destructor). + + + +These are normally marked up as methodname, but if you need to make a +synopsis of a method, there are specific elements available: constructorsynopsis and destructorsynopsis + + +To recap: + + + +Function + + +foo() + + + + +Methodname + +Kfoo::bar() + + + + +Constructor + + +Kfoo::Kfoo() These are methods in ordinary +text, but when making a synopsis, have a more specific tag to use. + + + + +Destructor + +Kfoo::~Kfoo() These are methods in +ordinary text, but when making a synopsis, have a more specific tag to +use. + + + + + + +Sometimes you really can't tell the difference, especially when they are +being mentioned in passing in the text. Also, programmers tend to +shorten and make shortcuts when referring to snippets of source. If +it's very unclear what something is, mark it up with function and ask the developer. + + + + +Asking a developer What is foo? will likely result in a +two page explanation of a finer point of C++ programming, which, if you +could understand it, you wouldn't have needed to ask the question in the +first place. It saves everyone a lot of time and frustration if you +word the question Out of function, method, constructor and +destructor, which is the best fit for foo?. + + + + + + + +varname + + +The name of a variable. + + + + + +returnvalue + + +The value returned by a function. + + + + + +token + + +A token is a placeholder, something that is replaced by an actual value +during processing. (I need to come up with a useful example for a token) + + + + + +constant + + +A constant. In the snippet: + +enum MyType { Red = 0, Green, Blue, Yellow }; +Red, Green, +Blue and Yellow should be +marked up as constant + + + + +type + + +Used to classify a value. In the snippet: + +enum MyType { Red = 0, Green, Blue, Yellow }; +MyType is a type + + + + +programlisting + + +Use this to wrap any source code examples in your document. You don't +need to use this for short snippets that are inline in the text, but you +should use it for any examples longer than a line or two, or that are a +separate block of text. + + + + + +structname,structfield + + +Not used in &tde; Documentation, primarily because they are rare +in &tde; source code, and are almost certainly never going to require +marking up. + + + + + +parameter + + +Parameters can be used for commandlines as well as for code samples. + + + + + +classsynopsis + + +A class synopsis + + + + +DCOPStub + +? not sure about what goes here ? +enum Status + +CallSucceeded + + +CallFailed + + + + + + + + +initializer + + +An initializer + + + + + +exceptionname + + +An exception name + + + + + + + + + + + + + + + +Making Callouts + + +Callouts are difficult, so they have their own chapter. Use callouts +when you want to refer from text to specific parts of an image, +programlisting, or synopsis. Using callouts with graphics is currently +unused, and is somewhat problematic, so they will not (yet) be described +here. + + + + + +calloutlist + + +A list element that contains the callouts themselves. That is, a list +of the explanations that belong to the indicated areas in the item being +explained. + + + + + +callout +arearefs="" + + +The actual explanation or description of the called out area or line. +The arearefs attribute should +contain the id of the appropriate callout you are referring to. + + + + + +programlistingco +and screenco + + +Callouts applied to a programlisting or a screen element. Although they +look more difficult than just embedding the callouts directly in the +text, they really aren't too hard. The programlistingco contains one +areaspec, and one programlisting. The screenco contains one areaspec +and one screen element. The programlisting and screen elements are +exactly as you would normally have. + + + + +areaspec + + +The areaspec contains a list of area elements, each of which describes +one single callout. + + + + + +area coords="" +id="" + + +The area is another of the very few empty elements, so there is no +area. The id attribute should contain a unique name +for the item. The coords contains +a pair of numbers which indicate first the line and then the column +where the co should appear. The line and column refer to the position +in relation to the container element, not the entire +document!. That is, in a screenco, the line and column +numbers refer to the line within the screen element. + + + + + + + + + +Marking up callouts with <sgmltag +class="starttag">screenco</sgmltag>. + + +<screenco> + <areaspec> + <area coords="2 65" id="currentdir"/> + <area coords="3 65" id="updir"/> + <area coords="4 75" id="hiddenfile"/> + <area coords="10 75" id="backupfile"/> + <area coords="13 70" id="hiddendir"/> + +<screen> +total 864 +drwx------ 8 vampyr vampyr 4096 Oct 2 18:01 ./ +drwxr-xr-x 13 root root 4096 Oct 1 16:32 ../ +-rw------- 1 vampyr vampyr 32 Sep 2 14:21 .MCOP-random-seed +-rw------- 1 vampyr vampyr 0 Sep 2 14:42 .Xauthority +-rw-r--r-- 1 vampyr vampyr 1899 Aug 6 19:32 .Xdefaults +-rw------- 1 vampyr vampyr 261 Sep 29 22:59 .bash_history +-rw-r--r-- 1 vampyr vampyr 24 Aug 6 19:32 .bash_logout +-rw-r--r-- 1 vampyr vampyr 285 Aug 6 19:34 .bash_profile +-rw-r--r-- 1 root root 230 Aug 6 19:32 .bash_profile~ +-rw-r--r-- 1 vampyr vampyr 559 Aug 6 19:32 .bashrc +-rw-r--r-- 1 vampyr vampyr 4044 Aug 6 19:32 .emacs +drwxr-xr-x 7 vampyr vampyr 4096 Sep 29 17:31 .trinity/ +</screen> +</screenco> +<calloutlist> +<callout arearefs="currentdir1"><para>The current directory.</para> +</callout> +<callout arearefs="updir1"> +<para>One directory up in the tree.</para> +</callout> +<callout arearefs="hiddenfile1"> +<para>A hidden file, indicated by the . beginning the name.</para> +</callout> +<callout arearefs="backupfile1"> +<para>A backup or temporary file, indicated by the ~ ending the name.</para> +</callout> +<callout arearefs="hiddendir1"> +<para>A hidden directory, which, like a hidden file, is indicated by the . at +the start of the name.</para> +</callout> +</calloutlist> + + + + +All this markup above, while it looks complicated is really quite simple +if you study it closely. It would generate the following: + + + + + + + + + + + + +total 864 +drwx------ 8 vampyr vampyr 4096 Oct 2 18:01 ./ +drwxr-xr-x 13 root root 4096 Oct 1 16:32 ../ +-rw------- 1 vampyr vampyr 32 Sep 2 14:21 .MCOP-random-seed +-rw------- 1 vampyr vampyr 0 Sep 2 14:42 .Xauthority +-rw-r--r-- 1 vampyr vampyr 1899 Aug 6 19:32 .Xdefaults +-rw------- 1 vampyr vampyr 261 Sep 29 22:59 .bash_history +-rw-r--r-- 1 vampyr vampyr 24 Aug 6 19:32 .bash_logout +-rw-r--r-- 1 vampyr vampyr 285 Aug 6 19:34 .bash_profile +-rw-r--r-- 1 root root 230 Aug 6 19:32 .bash_profile~ +-rw-r--r-- 1 vampyr vampyr 559 Aug 6 19:32 .bashrc +-rw-r--r-- 1 vampyr vampyr 4044 Aug 6 19:32 .emacs +drwxr-xr-x 7 vampyr vampyr 4096 Sep 29 17:31 .trinity/ + + + +The current directory. + + +One directory up in the tree. + + +A hidden file, indicated by the . beginning the name. + + +A backup or temporary file, indicated by the ~ ending the name. + + +A hidden directory, which, like a hidden file, is indicated by the . at +the start of the name. + + + + + +co + + +Indicates where a callout is. For &tde; HTML +documentation, a small numbered graphic will be placed here, and also at +the location of the explanation. These numbered graphics are links +between the two places. It is entirely possible to embed the callout +elements directly in the text you are describing, and this is perhaps +the easiest way to do it. It isn't the most specific, but working out +the line coordinates to use the more precise elements is difficult, so +this way is acceptable for now. + + + + + + +Marking up callouts by embedding directly in text + + +<screen> +drwxr-xr-x 3 vampyr vampyr 4096 Aug 6 19:32 .triniity/ +lrwxrwxrwx 1 vampyr vampyr 15 Sep 3 19:46 +.tdeinit-whiterabbit.magicians.org-:0 -> /tmp/.kinV4m2iI= <co id="symlink"/> +-rw-r--r-- 1 vampyr vampyr 2096 Aug 6 19:32 .tderc +-r-------- 1 vampyr vampyr 21 Sep 2 14:21 .kxmlrpcd +-rw-r--r-- 1 vampyr vampyr 185 Aug 6 19:32 .mailcap +-rw------- 1 vampyr vampyr 31 Sep 2 14:21 .mcoprc +drwxr-xr-x 4 vampyr vampyr 4096 Aug 6 19:32 .netscape/ +-rw------- 1 vampyr vampyr 777947 Sep 2 14:42 .xsession-errors +drwxr-xr-x 5 vampyr vampyr 4096 Sep 2 14:42 Desktop/ <co id="dir"/> +drwx------ 2 vampyr vampyr 4096 Aug 6 19:32 tmp/ +-rw-r--r-- 1 vampyr vampyr 3836 Oct 13 16:44 notes.txt <co id="file"/> +</screen> + +<calloutlist> +<callout arearefs="symlink"> +<para>A symbolic link, indicated by the ->, and showing the location it is +linked to.</para> +</callout> +<callout arearefs="dir"> +<para>An ordinary directory.</para> +</callout> +<callout arearefs="file"> +<para>An ordinary file.</para> +</callout> +</calloutlist> + + + +Again it's really not as hard as it looks on first glance. This markup +would generate the following: + + + +drwxr-xr-x 3 vampyr vampyr 4096 Aug 6 19:32 .trinity/ +lrwxrwxrwx 1 vampyr vampyr 15 Sep 3 19:46 +.tdeinit-whiterabbit.magicians.org-:0 -> /tmp/.kinV4m2iI= +-rw-r--r-- 1 vampyr vampyr 2096 Aug 6 19:32 .tderc +-r-------- 1 vampyr vampyr 21 Sep 2 14:21 .kxmlrpcd +-rw-r--r-- 1 vampyr vampyr 185 Aug 6 19:32 .mailcap +-rw------- 1 vampyr vampyr 31 Sep 2 14:21 .mcoprc +drwxr-xr-x 4 vampyr vampyr 4096 Aug 6 19:32 .netscape/ +-rw------- 1 vampyr vampyr 777947 Sep 2 14:42 .xsession-errors +drwxr-xr-x 5 vampyr vampyr 4096 Sep 2 14:42 Desktop/ +drwx------ 2 vampyr vampyr 4096 Aug 6 19:32 tmp/ +-rw-r--r-- 1 vampyr vampyr 3836 Oct 13 16:44 notes.txt + + + + +A symbolic link, indicated by the ->, and showing the location it is +linked to. + + +An ordinary directory. + + +An ordinary file. + + + + + + +imageobjectco + + +Currently unused in &tde; Documentation. + + + + + +mediaobjectco + + +Currently unused in &tde; Documentation. + + + + + + +areaset + + +Currently unused in &tde; Documentation. This and the +above two elements will be used eventually (just as soon as I figure out +how they work). + + + + + + +graphicco + + +Not to be used in &tde; Documentation at all. + + + + + + + + + +References, indexes, and glossaries + + +These elements are very underused in &tde; Documentation up to this point, +and we will probably make an effort to implement them more fully at some +point. In the meantime, you may use them if you wish, so they are +explained here. + + + +Making a glossary + + + +glossterm + + +Use this inline to identify words in the text that are explained further +in a glossary or glosslist. When it's placed inside a +glossentry it contains the term that +glossary entry is defining (see the example below to see this in +action.) + + + + + +glossary + + +Put this where you have the glossary appearing. This is usually +at the end of the document, perhaps last before the credits section, or before +an index. A glossary will become a separate section in the book. + + + + + +glosslist + + +Use this if the glossary is fairly short and simple. It can +appear anywhere a normal list could appear. For &tde; Documentation, a proper +glossary is preferred, so keep use of glosslist to a minimum, where your glossary +would only contain a small handful of entries. Use your own judgement +which is most appropriate. You might use a glosslist for example, to +explain a list of terms which only appear in one section, but are very +important to understanding that section and occur several times there, +so you want the explanations to appear close to the text. + + + + +glossdiv + + +Divides a glossary into several smaller sections. A good use of this in +a very large glossary could be to break it up into separate sections for +each letter in the alphabet. + + + + + +glossentry +id="" + + +Contains the actual entries in the glossary or glosslist, where you +explain the terms you have marked up with glossterm in the text. You +should give these an id, so they +can be linked to from the text, and crossreferenced between glossary +entries. + + + +A glossentry always contains one +glossterm. It also contains one glossdef, +or one glosssee, or a glossdef +and a glossseealso. + + + + +I would suggest a consistent naming scheme, so glossary entries are easy +to reference without having to go look them up all the time. For +example, I use the form id="gloss-word", +where word is the term that is being +explained. + + + + + +glossdef + + +Contains the actual definitions of the terms + + + + + +glosssee +otherterm="" + + +You can use this to save duplicating entries in the glossary. Instead +of a glossdef you can put glosssee with the id of +another glossentry. + + + + + +glossseealso +otherterm="" + + +This is very similar to glosssee, +but instead of replacing the glossdef it is in addition to +it. + + + + + + +If you compare a glossary entry to a variable list entry, you'll see the +structure is quite similar, with a glossterm taking the place of the term, and a glossdef taking the place of the listitem. Since variable lists get heavy use +in &tde; Documents, it shouldn't take you long to pick up how to do a +glossary. + + + +How to markup a glossary + + +Say you have in the text of the document the following sentence: + + +

+ +KWord is a graphical, wysiwyg word processor, and is part of KOffice. + +
+ + +You want to have the words KWord and koffice in the index, and KWord, +wysiwyg, word processor and KOffice explained in a +glossary. + + + +Many of these terms also need to be marked up with other tags, such as +application, and acronym. + + +The eventual markup would look like this: + + + +<para><glossterm linkend="gloss-kword">KWord</glossterm> +<indexterm><primary>KWord</primary></indexterm> is a +graphical <glossterm linkend +="gloss-wysiwyg"><acronym>WYSIWYG</acronym></glossterm> +<glossterm linkend="gloss-word-processor">word +processor</glossterm>, and is part of <glossterm +linkend="gloss-koffice">KOffice</glossterm>. +<indexterm><primary>KOffice</primary></indexterm></para> + + + + +The next part is shown here as a glosslist, and if there were really only this +many entries in it, that could be entirely appropriate. In reality, if +you are going to make a glossary, it would have many more entries and so +would warrant it's own glossary +section. The syntax inside glossary +and glosslist are otherwise the +same. + + + + +<glosslist> +<glossentry id="gloss-kword"> +<glossterm>KWord</glossterm> +<glossdef><para>The name of the TDE word +processor</para></glossdef> +</glossentry> + +<glossentry id="gloss-koffice"> +<glossterm>KOffice</glossterm> +<glossdef><para>A collection of office productivity tools, designed +by and for <acronym>TDE</acronym>, including presentation software, +a word processor, a spreadsheet, a <acronym>PIM</acronym>, and a +vector illustration application.</para></glossdef> +</glossentry> + +<glossentry id="gloss-word-processor"> +<glossterm>word processor</glossterm> +<glossdef><para>An application for handling text, typically more +concerned with formatting visually than a plain text +editor.</para></glossdef> +</glossentry> + +<glossentry id="gloss-wysiwyg"> +<glossterm>WYSIWYG</glossterm> +<glossdef><para>Stands for <quote>What You See Is What You +Get</quote>, indicating that you can visually format the presentation of +your data onscreen, and when you print the document, it will look exactly as you +see on the screen.</para></glossdef> +</glossentry> +</glosslist> + + + + +And the result of all this would be as follows: + + + +KWord +KWord is a graphical +WYSIWYG word processor, and is part +of KOffice.KOffice. + + + + +KWord +The name of the TDE word processor + + + +KOffice +A collection of office productivity tools, designed by and for +TDE, including presentation software, a word processor, a +spreadsheet, a PIM, and a vector illustration +application. + + + +word processor +An application for handling text, typically more concerned with +formatting visually than a plain text editor. + + + +WYSIWYG +Stands for What You See Is What You Get, +indicating that you can visually format the presentation of your data onscreen, +and when you print the document, it will look exactly as you see on the +screen. + + + + + + + +Making an Index + + +For &tde; Documentation, indexes will in the future be generated +automatically, so many of these elements are not to be used directly +when authoring. At this stage, indexes are not generated, but if you +want to you can mark up words that should be indexed with the indexterm element, to save work for later. + + + + +indexterm + + + +Use this to note places in the main text of the document that should +have an entry in the index. Don't over use it - not every single +occurrence of a word needs to be noted in the index, but every +occurrence where that term is significant should be. + + + +indexterm should contain a primary, which contains the text that the +entry will appear under in the index. + + + +Place the indexterm directly before +the word you want to index, and place the word itself inside the primary +element. If the word should also be listed under a secondary heading, +place that term inside a secondary element. + + + +Index + +Say the document contains the following sentence: + +
KWord is a graphical, wysiwyg word processor, and is part of +KOffice.
+ +You want KWord to have an index entry of it's own, and to also be noted +under KOffice in the index. + + + +<para><application>KWord</application> +<indexterm><primary>KWord</primary><secondary>KOffice</secondary></indexterm> +is a graphical, <acronym>WYSIWYG</acronym> word processor, and is part of +KOffice.</para> + + + +The fact that an index entry exists is not normally indicated by a change +in appearance. + + +If you think it should also be added under a third heading in the index, +you can use tertiary to indicate this. Most terms you would find in &tde; +Documentation will only need a primary index heading, so use the others +sparingly, if at all. + + + + +tertiary +tertiary + +seealso +seealso + + + + +The following elements are used to create the actual index, but they are +automatically generated, if required. You should not use them when +authoring documents. + + + + + +index + + + + +indexdiv + + + + +indexentry + + + + +primaryie + + + + +secondaryie + + + + +see + + + + +seealsoie + + + + +seeie + + + + +tertiaryie + + + + + + +Other Reference Sections + + + + +firstterm + + +Mark up the first occurence of a technically significant term with this +element. If you are creating a glossary or an index, the first occurence +of a term will probably also warrant being an entry in one or both. + + + + + +refsynopsisdivinfo + + +refsynopsisdivinfo + + + + + +refnamediv + +refnamediv + + + + + +refclass + + +refclass + + + + + +refmeta + + +refmeta + + + + + +refsect1,refsect2 +and refsect3 + + + +refsect1, refsect2 and refsect3 + + + + + +refmiscinfo + + +refmiscinfo + + + + + +refsect1info,refsect2info and refsect3info + + +refsect1info, refsect2info and refsect3info + + + + + +refdescriptor + + +refdescriptor + + + + + +setindex + + +Not Used in &tde; Documentation + + + + + +refpurpose + + +refpurpose + + + + + +reference + + +reference + + + + + +refentrytitle + + +refentrytitle + + + + + +refname + + +refname + + + + + +refentry + + +refentry + + + + + +refsynopsisdiv + + +refsynpsisdiv + + + + + + + + + + +Tags we do not use + + +These are tags that are available for DocBook &XML;, but we have decided +they will not (at this time) be used for &tde; Documentation. They are +included here for completeness, and so nobody can say I didn't +know I wasn't supposed to use that! + + + +They fall into two categories: Tags we have definitely decided to not +use, in which case we have made a decision to use another tag instead, +and tags that are just irrelevant to the documentation we are doing, +which you hopefully will never want. Should we write new documentation +that can sensibly be marked up with any of these elements, this list +will be revised. + + + +If you think you have a use for one of these elements, please, check +with the DocBook team first, and be prepared to justify your case. + + + +ackno +alt +appendixinfo +artheader +article +articleinfo +artpagenums +audiodata +audioobject +authorblurb +authorinitials +beginpage +bibliodiv +biblioentry +bibliography +bibliographyinfo +bibliomisc +bibliomixed +bibliomset +biblioset +bookbiblio +bridgehead +chapterinfo +citation +citerefentry +citetitle +city +collab +collabname +colophon +colspect +comment +confdates +confgroup +confnum +confsponsor +conftitle +contractnum +contractsponsor +corpname +country +database +dedication +docinfo +edition +editor +entrytbl +fax +figure +formalpara +sgmltag +graphic +highlights +honorific +indexinfo +informalequation +informalfigure +inlineequation +inlinegraphic +interfacedefinition +interfacename +invpartnumber +isbn +issn +issuenum +itermset +jobtitle +lineage +lot +lotentry +manvolnum +medialabel +modespec +msg +msgaud +msgentry +msgexplan +msginfo +msglevel +msgmain +msgorig +msgrel +msgset +msgsub +objectinfo +olink +orgdiv +orgname +otheraddr +pagenums +part +partintro +phone +pob +postcode +preface +prefaceinfo +printhistory +productname +productnumber +property +pubdate +publisher +publishername +pubsnumber +qandadiv +refentryinfo +referenceinfo +remark +revdescription +revhistory +revision +revnumber +revremark +secondary +section +sectioninfo +seriesinfo +seriesvolnums +set +setindexinfo +setinfo +shortaffil +sidebar +sidebarinfo +simpara +simplemsgentry +simplesect +spanspec +state +street +subject +subjectset +subjectterm +subtitle +systemitem +titleabbrev +toc +tocback +tocchap +tocentry +tocfront +toclevel1 +toclevel2 +toclevel3 +toclevel4 +toclevel5 +tocpart +videodata +videoobject +volumenum +wordasword + + + + +Alphabetical List of all elements + + +This is a list of all the markup elements contained in DocBook XML +4.1.2. Choose the element you are interested in to go directly to the +section of this document which describes it. + + + + +We don't use all these elements in &tde; Documentation - they are here +for completeness. Elements we don't use are listed in . + + + + +authorinitials + +beginpage +bibliodiv +biblioentry +bibliographyinfo +bibliomset +bibliomisc +bibliomixed +biblioset +bibliography +blockquote +book +bookbiblio +bookinfo +bridgehead +co +callout +calloutlist +caption +caution +chapter +chapterinfo +citation +citerefentry +citetitle +city +classname +classsynopsis +classsynopsisinfo +cmdsynopsis +colspec +collab +collabname +colophon +command +comment +computeroutput +confdates +confgroup +confnum +confsponsor +conftitle +constant +constructorsynopsis +contractnum +contractspnosor +contrib +copyright +corpauthor +corpname +country +database +date +dedication +destructorsynopsis +docinfo +edition +editor +email +emphasis +envar +entry +entrytbl +epigraph +equation +errorcode +errorname +errortype +example +exceptionname +fax +figure +fieldsynopsis +filename +firstterm +footnote +footnoteref +foreignphrase +formalpara +funcdef +funcparams +funcprototype +funcsynopsis +funcsynopsisinfo +function +guibutton +guiicon +guilabel +guimenu +guimenuitem +guisubmenu +glossdef +glossdiv +glossentry +glosslist +glosssee +glossseealso +glossterm +glossary +glossaryinfo +graphic +graphicco +group +hardware +highlights +holder +honorific +isbn +issn +itermset +imagedata +imageobject +imabeobjectco +important +index +indexdiv +indexentry +indexinfo +indexterm +informalequation +informalexample +informalfigure +informaltable +initializer +inlineequation +inlinegraphic +inlinemediaobject +interface +interfacedefinition +interfacename +invpartnumber +issuenum +itemizedlist +jobtitle +keycap +keycode +keycombo +keysym +keyword +keywordset +legalnotice +lineannotation +lineage +link +listitem +literal +literallayout +lot +lotentry +manvolnum +markup +medialabel +mediaobject +mediaobjectco +member +menuchoice +methodname +methodparam +methodsynopsis +modespec +modifier +mousebutton +msg +nmsgaud +msgentry +msgexplan +msginfo +msglevel +msgmain +msgorig +msgrel +msgset +msgsub +msgtext +note +olink +objectinfo +option +optional +orderedlist +orgdiv +orgname +otheraddr +othercredit +othername +pob +pagenums +para +paramdef +parameter +part +partintro +phone +phrase +postcode +preface +prefaceinfo +primary +primaryie +printhistory +procedure +productname +productnumber +programlistingco +prompt +property +pubdate +publisher +publishername +pubsnumber +qandadiv +qandaentry +qandaset +question +quote +refclass +refdescriptor +refentry +refentryinfo +refentrytitle +referenceinfo +refmeta +refmiscinfo +refname +refnamediv +refpurpose +refsect1 +refsect1info +refsect2 +refsect2info +refsect3info +refsect3info +refsynopsisdiv +refsynopsisdivinfo +reference +releaseinfo +remark +replaceable +returnvalue +revdescription +revhistory +revnumber +revremark +revision +row +sbr +sgmltag +screen +screenco +screeninfo +screenshot +secondary +secondaryie +sect1 +sect1info +sect2 +sect2info +sect3 +sect3info +sect4 +sect4info +sect5 +sect5info +section +sectioninfo +see +seealso +seealsoie +seeie +seg +seglistitem +segmentedlist +seriesinfo +seriesvolnums +set +setindex +setindexinfo +setinfo +shortaffil +shortcut +sidebar +sidebarinfo +simpara +simplelist +simplemsgentry +simplesect +spanspec +state +step +street +structfield +structname +substeps +subject +subjectset +subjectterm +subscript +subtitle +superscript +surname +symbol +synopfragment +synopsis +systemitem +tbody +tfoot +tgroup +thead +table +term +tertiary +tertiaryie +textobject +tip +title +titleabbrev +toc +tocback +tocchap +tocentry +tocfront +toclevel1 +toclevel2 +toclevel3 +toclevel4 +toclevel5 +tocpart +token +trademark +type +ulink +userinput +varargs +varlistentry +varname +variablelist +videodata +videoobject +void +volumenum +warning +wordasword +xref +year + + + + + +Credits and License +Document copyright 2000, 2001 Lauri Watts +lauri@kde.org + + +This reference was written with substantial help and input from the +following people who definitely deserve credit: + + + +Frederik Fouvry +Eric Bischoff +Michael McBride +Lee Wee Tiong +Philip Rodrigues +Eyal Lotem +GNUPeaker@yahoo.com +Malte Starostik +malte.starostik@t-online.de +Antonio Larossa Jiminez + + +&underFDL; + + + +Entities + +TODO + + + + diff --git a/doc/tutorials/styleguide/CMakeLists.txt b/doc/tutorials/styleguide/CMakeLists.txt new file mode 100644 index 0000000..396682f --- /dev/null +++ b/doc/tutorials/styleguide/CMakeLists.txt @@ -0,0 +1,9 @@ +################################################# +# +# Improvements and feedback are welcome +# +# This file is released under GPL >= 2 +# +################################################# + +tde_create_handbook( DESTINATION khelpcenter/styleguide ) diff --git a/doc/tutorials/styleguide/Makefile.am b/doc/tutorials/styleguide/Makefile.am new file mode 100644 index 0000000..4169155 --- /dev/null +++ b/doc/tutorials/styleguide/Makefile.am @@ -0,0 +1,3 @@ +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/tutorials/styleguide/index.docbook b/doc/tutorials/styleguide/index.docbook new file mode 100644 index 0000000..8c94356 --- /dev/null +++ b/doc/tutorials/styleguide/index.docbook @@ -0,0 +1,466 @@ + +The &kde; Documentation Team'> + + +]> + + + + +The &tde; Style Guide + + +&kde-authors; +&tde-authors; + + + +2002 +The KDE e.V. + + +&tde-copyright-date; +&tde-team; + + +&FDLNotice; + +&tde-release-date; +&tde-release-version; + + + +A reference guide to &tde; style standards for writing documentation. +Please report any errors or omissions to +trinity-devel@lists.pearsoncomputing.net. + + + + +TDE +Docbook +Documentation +Authors + + + + + +Introduction + +The purpose of writing documentation for the &tde; Project, is +to create for all the users, a complete, well organized set of +documentation for each and every component of the &tde; project. In +order to achieve this goal, we have drafted the following guide to +help. + +This document is very new, and at the moment, very +sparse. + +If you have comments or additions, please do not hesitate to +suggest them on the kde-doc-english@kde.org mailing list. + +In the meantime, here are some short notes based on content that +was previously on the &tde; +i18n website. + + + + +Consistency + + +Dates and Revision Numbers + +While it may seem like a minor issue, and a minor part of your +document, it is very important that the following guidelines are +adhered to: + + + +All dates which are part of the text of your document +should be spelled out &ie; March 2, 2000 +This is the only way to be sure that 03/02/2000 +is interpreted correctly in all languages, and by all readers. +Exception: in the date tag, dates +should be in the YYYY-MM-DD format. + + + +All information included between the releaseinfo and releaseinfo should match the release number +of the application. + + + + + +Screenshot Consistency + +To create consistent screenshots, use an environment where all requirements can +be configured without interfering with your normal production environment. One option +is a virtual machine. Another option is creating at least two themes. One theme is the +normal everyday theme for production. The other theme is for handbook screenshots. +Toggle between the two themes as necessary. A third option is a separate user +account configured as required. + +To strive for a look of consistency with screenshots, please abide by the +following requirements. + + + + +No personal information. That includes login names. Be careful when including +window decorations because the title bar could include such information. Use a testing +account or a virtual machine when such information cannot be avoided. + + +Use &ksnapshot;. Normally use the Window Under Cursor option. Use the + &ksnapshot; Handbook to learn more. + + +Using the &ksnapshot; Include window decorations option is not +required and not forbidden. Just ensure the decorations to do not interfere with the +purpose of the screenshot. + + +PNG images only. + + +Window decorations: KDE2, Keramik, or Plastik. + + +Widget style: KDE Classic, Keramik, or Plastik. + + +In &kcontrol;->Style, enable Show icons on buttons. + + +Colors: TDE defaults. + + +Background: No wallpaper, no gradients. + + + + + + + +Other Consistency Issues + + + +Please submit only plain ASCII text, or +Docbook &XML;. Anything else will be returned to you. (Docbook &XML; is +preferred.) + + +Make sure you first read, and follow, the documentation template +provided. You can find this in the source folder for &tde;. Simply +point a browser to tdelibs/doc/kdoctools/template.docbook +If there is existing documentation (from the developer, or +from &tde; 1.x or 2.x), then use that as a base to work from, but it +needs to conform to the layout from the documentation +template. + + +Spell things according to Standard American spelling, except for +proper names, places, &etc; + + +Make sure to set your spell checker to US English. Make sure you +use your spell checker. + + +If there is a non-English word, which is used in an English +sentence, be sure to spell this correctly, using appropriate accent +marks, and any special characters. Use the &kcharselect; application +if you don't have the correct keys on your keyboard. + + +Abbreviations should be capitalized, unless they are +specifically intended to not be capitalized. (&ie; is a good +example). + + +Punctuation within numbers should be Americanized: +10,000.00 + + +It is more legible to use written numbers where the number has +no technical value, ⪚ There are three buttons on the +dialog. In this context 3 is not technically +significant. Numbers with technical significance should be written as +figures. (&ie; a 10 MB file, not a ten MB +file.) + + +Spell check and proofread your work before you send it in. Or +even better, have someone else read it over. Spell checking programs +won't catch incorrect words such as using their for +there. + + + + + + + +Writing Well + +Some things to think about when writing documentation + +How many times have you attempted to read a man page, and given +up in frustration — all the facts are there, but the writing is +too dry and technical for you to make sense of them? We want to avoid +this with the documentation you're writing. + +It's difficult to avoid the very dry, choppy style we're all too +familiar with, but do try to make the writing flow and keep it +user-friendly. Try to be as friendly as you can +manage without being patronizing, and without sacrificing clarity or +detail. + + Things you should consider: + + + + +Make sure you explain all aspects of the interface, and that you +don't leave out any command line options available. + + + +It's important to keep a logical progression of difficulty. Keep +the first few pages of the document simple, and accessible to users +who have never seen the application before. More technical information +should appear towards the end of the document. + + + +Be sure to write to the level of the intended reader. By this we +mean, a Samba control module has a very different user base than a +user of a game, and the manuals should reflect this. Don't insult the +Samba networker's intelligence, and don't assume knowledge for the +gamer that might not be there. + + + +It is highly encouraged to use screenshots, pictures of action +buttons, &etc; These are &GUI; applications, and a picture can be worth a +thousand words. + + + +Please define computer abbreviations, unless they are well +understood by all computer users (There's no need to define +RAM, PC, &etc;). + +For example, If you are going to use +PPP (Point to Point Protocol), +then...... Define it only once though, in this example you +could now use PPP without explanation for the rest +of the document. + +The first time you introduce the word you should use firstterm or consider setting up a glossary +and using glossentry. + + + +Remember the small things: If it's dockable, explain how to do +that. Don't forget to mention where it installs itself in the K +menu. If there are any environment settings required, and if they must +be set manually, explain how to do that - if they're set +automatically, they still need to be documented. + + + +Write something you would be happy to read as a user who doesn't +know how the application works. Perhaps if you have a friend or family +member who isn't familiar with the application you're writing about, +have them work through using it, with your documentation as a +guide. + + + + + + +Other general tips and hints for good writing + +A good way to catch simple errors is to read the text out loud, +or have someone else read it to you. Passages that don't +flow or have obviously awkward construction of the type +you may miss on the screen, will usually become blindingly obvious +when you hear them. This is especially the case with detecting really +long sentences, as you will run out of breath and turn blue. + +Be concise, be specific, and be direct. Choose your words +carefully, and be certain you know the exact meaning of every word +you use. Is it the right word? Use a dictionary, and find out. + +Use complete sentences. Not fragments. Like these ones. + +While talking about sentences: + + +Avoid run on sentences, sentences that cover several different +subjects, or sentences that could be broken up into several sentences; +avoid sentences that can fill a whole paragraph all by themselves and +that are really long, like this one, which is all of the above. + + + +Use a comma before and in compound sentences, ⪚ +Use the left mouse button to select and copy text, and the +middle mouse button to paste it. + + +Keep to logical sentence order. +For example, &konqueror; is a web browser with the +ability to browse file systems and it includes a javascript +interpreter. (Do you see why this is awkward?) + + +Try not to use the same word several times in the same sentence. +An exception to this, is an application command or technical word, +where this repetition is necessary, and improves clarity. + + +Do not start sentences with any of and, +so, but, because, or +however. + + +Try to avoid contractions, rather spell out both words; ⪚, +it is rather than it's; can +not rather than can't + + +There is no need to worry about simple text formatting such as +leaving two spaces after punctuation or indenting paragraphs. This is +all handled by Docbook &XML; and the XSLT +stylesheets in use. + + + +Remember, we have also an active proofreading team, and there is +always someone to help you with grammar, so just +write and have fun! + + + + +Resources + + +General Purpose Websites + +A few sites you may find worth bookmarking, or at least +visiting. + + +Dictionary Sites + + + +Merriam Webster +Online + + +Dictionary.com + + + + + + +Thesaurus Sites + + + +Merriam-Webster have a +thesaurus as well as a dictionary + + +Roget's +Thesaurus + + + + + + +Style Guides and Other Resources + + + +Strunk & +White is the base style guide for many newspapers and press +galleries. If you want to look up a grammar or usage question, this is +the place to go. + + +The alt.usage.english newsgroup. +If you'd like every sentence chewed over, dissected, and then +rewritten several conflicting ways, or some great advice about bacon, +you'll find both here. Many real live editors and authors hang out +here, and they do know their stuff. Just make sure you read all ten +or so FAQ's before asking a question. + + +Other possibly useful sites + + +The Wired + Style Guide Bookmarks section + + + +http://www2.rscc.cc.tn.us/~jordan_jj/OWL/Clutter.html +If you tend to write very wordy sentences, here's a page with some +help for you. Includes a useful table of ways to rewrite common +mistakes. + + +http://owl.english.purdue.edu/Files/116.html + is a page about how to make sentences flow +better + + + + + + + + + + + +Credits and Licenses + +The &tde; Documentation Style Guide + + +Copyright 2002, Lauri Watts, Mike McBride, Eric Bischoff, +Frederik Fouvry. +Copyright &tde-copyright-date;, &tde-authors;. + +&underFDL; + + + + + + diff --git a/tutorials/.directory b/tutorials/.directory new file mode 100644 index 0000000..9efae07 --- /dev/null +++ b/tutorials/.directory @@ -0,0 +1,105 @@ +[Desktop Entry] +Name=Tutorials +Name[bg]=Ръководства +Name[ca]=Programes d'aprenentatge +Name[cs]=Návody +Name[csb]=Tutoriale +Name[cy]=Hyfforddiadau +Name[da]=Øvelser +Name[de]=Anleitungen +Name[el]=Οδηγός χρήσης +Name[eo]=Eklerniloj +Name[es]=Tutoriales +Name[et]=Õppematerjalid +Name[fo]=Skeið +Name[fr]=Didactitiels +Name[hr]=Praktični vodič +Name[hu]=Bevezetők +Name[id]=Tutorial +Name[is]=Kennsluefni +Name[it]=Esercitazioni +Name[ja]=チュートリアル +Name[km]=បង្រៀន +Name[ko]=따라하기 +Name[lo]=ການສອນ +Name[lt]=Vadovai +Name[mn]=Давтлага +Name[nb]=Veivisere +Name[nds]=Inföhren +Name[nl]=Handleidingen +Name[nn]=Innføringar +Name[nso]=Dithutokopana +Name[oc]=Introduccions +Name[pl]=Podręczniki +Name[pt]=Tutoriais +Name[pt_BR]=Tutoriais +Name[ro]=Tutoriale +Name[ru]=Обучение +Name[sk]=Návody +Name[sl]=Učbeniki +Name[sr]=Туторијали +Name[sr@Latn]=Tutorijali +Name[sv]=Handledningar +Name[tg]=Дастурҳо +Name[th]=ฝึกสอน +Name[tr]=Kılavuzlar +Name[uk]=Посібники +Name[ven]=Dzikilasi dzau haseledza +Name[wa]=Tutoriås +Name[xh]=Izifundo zokuzikhumbuza +Name[zh_TW]=教學 +Name[zu]=izifundo zokubuyekeza +Comment=Tutorial and introduction documents. +Comment[az]=Leksika və giriş sənədləri +Comment[bg]=Ръководства и документи. +Comment[br]=Kelennant ha teulioù deraouiñ. +Comment[ca]=Curs d'aprenentatge i documents d'introducció. +Comment[cs]=Návody a základní dokumenty. +Comment[csb]=Tutorial ë wprowadzającé dokùmentë. +Comment[cy]=Dogfenni cyflwyniad a hyfforddiadol +Comment[da]=Øvelses- og introduktionsdokumenter. +Comment[de]=Anleitungen und Einführungen +Comment[el]=Οδηγός χρήσης και έγγραφα παρουσίασης. +Comment[eo]=Eklernilaj kaj enkondukaj dokumentoj +Comment[es]=Tutorial y documentos de introducción. +Comment[et]=Õppematerjalid ja sissejuhatused. +Comment[fr]=Didactitiels et documents de présentation +Comment[hi]=शिक्षण पाठ तथा परिचय दस्तावेज़ +Comment[hr]=Praktični vodič i uvodni dokumenti. +Comment[hu]=Bevezető jellegű dokumentumok. +Comment[id]=Tutorial dan dokumen Pengenalan +Comment[is]=Kennslu- og kynningarefni. +Comment[it]=Esercitazione e documenti introduttivi. +Comment[ja]=チュートリアルと導入用ドキュメント +Comment[km]=ឯកសារ​បង្រៀន និង​ណែនាំ ។ +Comment[ko]=소개와 따라하기 글입니다. +Comment[lo]=ການສອນແລະເອກະສານແນະນຳ +Comment[lt]=Vadovai ir įvadiniai dokumentai +Comment[lv]=Ievada un konsultāciju dokumenti. +Comment[mn]=Давтлага ба удиртгал баримтууд +Comment[mt]=Spjega u dokumenti ta' introduzzjoni. +Comment[nb]=Veivisere og introduksjonsdokumenter +Comment[nds]=Anleed- un Inföhrdokmenten +Comment[nl]=Handleiding en inleidende documenten. +Comment[nn]=Innføringar og introduksjonsdokument. +Comment[nso]=Thutokopana le ditokomane tsa matseno. +Comment[oc]=Documents e curs d'introduccion. +Comment[pl]=Podręczniki i dokumenty dla początkujących. +Comment[pt]=Tutoriais e documentos introdutórios. +Comment[pt_BR]=Tutoriais e documentos introdutórios. +Comment[ro]=Documente introductive și tutoriale. +Comment[ru]=Документы по обучению. +Comment[sk]=Dokumenty s úvodom a návodmi. +Comment[sl]=Učbenik in uvodni dokumenti +Comment[sr]=Туторијали и уводни документи. +Comment[sr@Latn]=Tutorijali i uvodni dokumenti. +Comment[sv]=Handlednings- och introduktionsdokument. +Comment[tg]=Дастурҳо ва ҳуҷҷатҳои пешниҳод +Comment[th]=เอกสารแนะนำและฝึกสอน +Comment[tr]=Kılavuzlar ve belgeler +Comment[uk]=Інструктаж і вступні документи. +Comment[ven]=Kilasi yau haseledza na mathomo a manwalwa +Comment[wa]=Tutoriå eyet documints di prezintaedje +Comment[xh]=Isifundo sokuzikhumbuza kunye nesiqalo samaxwebhu. +Comment[zh_TW]=教學與介紹文件。 +Comment[zu]=Ushicilelo lweziqalo kanye nezifundo zokubuyekeza diff --git a/tutorials/CMakeLists.txt b/tutorials/CMakeLists.txt new file mode 100644 index 0000000..c6732ad --- /dev/null +++ b/tutorials/CMakeLists.txt @@ -0,0 +1,11 @@ +################################################# +# +# Improvements and feedback are welcome +# +# This file is released under GPL >= 2 +# +################################################# + +install( FILES + .directory docprimer.desktop markup.desktop styleguide.desktop + DESTINATION ${DATA_INSTALL_DIR}/khelpcenter/plugins/Tutorials ) diff --git a/tutorials/Makefile.am b/tutorials/Makefile.am new file mode 100644 index 0000000..44bd9d9 --- /dev/null +++ b/tutorials/Makefile.am @@ -0,0 +1,4 @@ +tut_DATA = .directory docprimer.desktop markup.desktop styleguide.desktop +tutdir = $(kde_datadir)/khelpcenter/plugins/Tutorials + + diff --git a/tutorials/docprimer.desktop b/tutorials/docprimer.desktop new file mode 100644 index 0000000..b2d2a21 --- /dev/null +++ b/tutorials/docprimer.desktop @@ -0,0 +1,4 @@ +[Desktop Entry] +Name=The TDE Documentation Primer +DocPath=help:/khelpcenter/docprimer/index.html +Icon=khelpcenter diff --git a/tutorials/markup.desktop b/tutorials/markup.desktop new file mode 100644 index 0000000..3ac4ebb --- /dev/null +++ b/tutorials/markup.desktop @@ -0,0 +1,4 @@ +[Desktop Entry] +Name=The TDE DocBook Markup Guide +DocPath=help:/khelpcenter/markup/index.html +Icon=khelpcenter diff --git a/tutorials/styleguide.desktop b/tutorials/styleguide.desktop new file mode 100644 index 0000000..17235ba --- /dev/null +++ b/tutorials/styleguide.desktop @@ -0,0 +1,4 @@ +[Desktop Entry] +Name=The TDE Help Handbook Style Guide +DocPath=help:/khelpcenter/styleguide/index.html +Icon=khelpcenter