# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2023-09-12 13:09+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: Title =
#: kraft.adoc:1
#, no-wrap
msgid "The Kraft Handbook"
msgstr ""

#. type: Plain text
#: kraft.adoc:3
msgid "Ronald Stroethoff, Klaas Freitag"
msgstr ""

#. type: Title ==
#: kraft.adoc:16
#, no-wrap
msgid "Introduction"
msgstr ""

#. type: Plain text
#: kraft.adoc:19
msgid ""
"Kraft is a Qt and KDE application to organize office documents like quotes "
"and invoices in a small business. It eases the creation of documents and "
"helps with repeating tasks."
msgstr ""

#. type: Plain text
#: kraft.adoc:21
msgid ""
"Using Kraft, there is no need for fiddling with a text processor any "
"more. Documents are created by a few clicks, edited, generated and archived "
"automatically. Kraft generates high quality PDF output for printing, mailing "
"and archiving."
msgstr ""

#. type: Labeled list
#: kraft.adoc:22
#, no-wrap
msgid "Feature Overview"
msgstr ""

#. type: Plain text
#: kraft.adoc:25
msgid "Simple creation of offers, invoices and similar documents."
msgstr ""

#. type: Plain text
#: kraft.adoc:26
msgid "Customer management, deeply integrated with the mature KDE KAddressbook."
msgstr ""

#. type: Plain text
#: kraft.adoc:27
msgid "Maintenance of document relations, ie. Partial invoices vs. invoices."
msgstr ""

#. type: Plain text
#: kraft.adoc:28
msgid "Templates for document header- and footertexts and for document items."
msgstr ""

#. type: Plain text
#: kraft.adoc:29
msgid "Pre calculation of item prices."
msgstr ""

#. type: Plain text
#: kraft.adoc:30
msgid "Material management."
msgstr ""

#. type: Plain text
#: kraft.adoc:31
msgid "Configurable document creation in PDF format for print and email."
msgstr ""

#. type: Plain text
#: kraft.adoc:33
msgid ""
"The code of Kraft is open source and is released under the "
"https://en.wikipedia.org/wiki/GNU_General_Public_License[GNU General Public "
"License]."
msgstr ""

#. type: Plain text
#: kraft.adoc:38
#, no-wrap
msgid ""
"Kraft is driven by community of users, coders, artists and others by "
"voluntary work. +\n"
"Also this manual needs contributions! +\n"
" +\n"
" Learn more on "
"https://github.com/dragotin/kraft/blob/master/manual/Readme.md[how to "
"contribute]!\n"
msgstr ""

#. type: Title ==
#: kraft.adoc:40
#, no-wrap
msgid "First Use and Basic Configuration"
msgstr ""

#. type: Plain text
#: kraft.adoc:43
msgid ""
"When Kraft is started for the first time, it automatically enters the "
"initial setup process."
msgstr ""

#. type: Plain text
#: kraft.adoc:45
msgid ""
"During the initial setup you are asked to select a database to use and give "
"the name and address of your company."
msgstr ""

#. type: Plain text
#: kraft.adoc:47
msgid ""
"You can fill in your company address (that appears on the printed documents) "
"in two ways: in the setup procedure use the first tab *Select from "
"Addressbook* for to select your on address in KAddressBook (if you have "
"filled your own address in KaddressBook) or use the second tab *Manual "
"entry* for to fill in the information of the address from your company "
"manually. This step is necessary for the correct generation of your "
"documents as the address is automatically used in the document generation "
"step."
msgstr ""

#. type: Plain text
#: kraft.adoc:49
msgid "image:company_adress1.png[Company adress,float=\"right\"]"
msgstr ""

#. type: Plain text
#: kraft.adoc:52
msgid ""
"After the initial setup, select menu:Preferences[Settings].  That allows to "
"prepare Kraft correctly so it can be used in a proper way."
msgstr ""

#. type: Plain text
#: kraft.adoc:54
msgid "In the Preferences dialog we have the tabs:"
msgstr ""

#. type: Plain text
#: kraft.adoc:61
#, no-wrap
msgid ""
" *Document Defaults\n"
" *Taxes\n"
" *Documunt Types\n"
" *Wages\n"
" *Units\n"
" *Own identity\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:63
msgid "Each of the tabs allows to enter useful values for the specific use case."
msgstr ""

#. type: Title ===
#: kraft.adoc:64
#, no-wrap
msgid "Document Types"
msgstr ""

#. type: Plain text
#: kraft.adoc:67
msgid "At the first use you find a list of different document types, such as:"
msgstr ""

#. type: Plain text
#: kraft.adoc:69
msgid "Acceptance of order"
msgstr ""

#. type: Plain text
#: kraft.adoc:70
msgid "Delivery receipt"
msgstr ""

#. type: Plain text
#: kraft.adoc:71
msgid "Invoice"
msgstr ""

#. type: Plain text
#: kraft.adoc:72
msgid "Offer"
msgstr ""

#. type: Plain text
#: kraft.adoc:74
msgid "image:documentype.png[Document type,float=\"right\"]"
msgstr ""

#. type: Plain text
#: kraft.adoc:77
msgid ""
"Translate this types to your own language.  You can also add new ones and "
"remove document types you wont use."
msgstr ""

#. type: Title ====
#: kraft.adoc:78
#, no-wrap
msgid "Numbercycles"
msgstr ""

#. type: Plain text
#: kraft.adoc:82
msgid ""
"image:numbercycles.png[Numbercycles,float=\"right\"] Each document has to "
"have an unique identifier that identifies the document. There must not be "
"two documents in Kraft with the same identifier."
msgstr ""

#. type: Plain text
#: kraft.adoc:85
msgid ""
"The format of the identifier is configuratable in Kraft. For that, Kraft has "
"a concept of so called number cycles.  Number cycles are used to define the "
"form of the *document number* which is printed on every document."
msgstr ""

#. type: Plain text
#: kraft.adoc:89
msgid ""
"All documents of a certain type have identifiers taken out of one number "
"cycle. Each document type has a number cycle assigned. Different document "
"types can use the same number cycle to generate ids from. That way, for "
"example the document types Invoice and Final Invoice can use numbers from "
"the same number cycle, even thought they are different document types in "
"Kraft.  Number cycles are identified by their name.  User can create new "
"number cycles and edit them clicking on the button btn:[Edit Number "
"Cycles...]"
msgstr ""

#. type: Plain text
#: kraft.adoc:91
msgid ""
"The format of the document numbers are defined by a template that can "
"contain normal, fixed characters and also some variables that are replaced "
"by the respective values when the document is created."
msgstr ""

#. type: Plain text
#: kraft.adoc:94
msgid ""
"Each identifier needs to be unique, and thus has to contain a counter. Kraft "
"supports two types of counter: One (variable `%i`) is incremented globally "
"for every new document. The other (variable `%n`) is reset every day and "
"starts at 1 again on every new day.  In addition to the counter, more "
"information can be added to the template form an useful number. Examples are "
"a constant text or parts of the date."
msgstr ""

#. type: Plain text
#: kraft.adoc:96
msgid ""
"The default numbercycle delivered with Kraft contains the year, the month "
"and a serialnumber. That way you can compare offers or orders from last year "
"with this year or the month April of last year with the month April of this "
"year and get on this way an impression from the results of your business."
msgstr ""

#. type: Plain text
#: kraft.adoc:98
msgid "See the following table for available variables which can be used:"
msgstr ""

#. type: Table
#: kraft.adoc:115
#, no-wrap
msgid ""
"| `%y` or `%yyyy`  | the year of the document date.\n"
"| `%yy`            | the year of the document (two digits).\n"
"| `%w`             | the week number of the document date.\n"
"| `%ww`            | the week number of the document date with leading "
"zero.\n"
"| `%d`             | the day number of the document date.\n"
"| `%dd`            | the day number of the document date with leading "
"zero.\n"
"| `%m` or `%M`     | the month number of the document date.\n"
"| `%MM`            | the month number with leading zero.\n"
"| `%c`             | the customer id from kaddressbook\n"
"| `%type`          | the localised doc type (offer, invoice etc.)\n"
"| `%uid`           | the contact id of the client.\n"
"| `%i` .. `%iiiiii`| the unique counter\n"
"| `%n` .. `%nnnnnn`| the unique day counter (combine with date)\n"
"\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:118
msgid ""
"A number cycle template needs to contain either `%i` or `%n`, if not, `%i` "
"is appended automatically."
msgstr ""

#. type: Plain text
#: kraft.adoc:120
msgid ""
"Both `%i` and `%n` are numeric values. They can also be padded with with "
"leading zeros. The length is defined by the number of i's or n's put into "
"the template. For example, if a daily counter with length of three and "
"leading zeros is desired, `%nnn` has to be put into the template. This works "
"up to a length of six characters."
msgstr ""

#. type: delimited block _
#: kraft.adoc:123
msgid ""
"NOTE: The \"design\" of the numbercycles and document numbers is very "
"important. With the flexible system of templating Kraft can not prevent "
"invalid number cycles. It is in the responsibility of the user."
msgstr ""

#. type: Title ====
#: kraft.adoc:125
#, no-wrap
msgid "PDF Template"
msgstr ""

#. type: Plain text
#: kraft.adoc:128
msgid ""
"In the entry field Template File: the user can select a custom template for "
"this specific document type."
msgstr ""

#. type: Plain text
#: kraft.adoc:130
msgid ""
"If the file extension of the template file is `.trml`, the ReportLab based "
"document converter is used. If the file extension is `.gtmpl`, Kraft "
"automatically uses the Weasyprint based converter."
msgstr ""

#. type: delimited block _
#: kraft.adoc:133
msgid ""
"NOTE: The ReportLab system for PDF creation is deprecated in Kraft. Please, "
"for new templates, always use Grantlee- and Weasyprint based templates."
msgstr ""

#. type: Title ====
#: kraft.adoc:135
#, no-wrap
msgid "PDF Postprocessing"
msgstr ""

#. type: Plain text
#: kraft.adoc:138
msgid ""
"After Kraft has created the PDF document it is possible to merge the created "
"PDF with static, customized PDFs created by the user. With that, it is easy "
"to add a custom stationery with a logo to the resulting PDF (\"Watermark\")."
msgstr ""

#. type: Plain text
#: kraft.adoc:140
msgid ""
"The static PDFs should have the same page size as the generated "
"documents. Keep in mind to use optimized images for logos etc. to not blow "
"up the size of the result document."
msgstr ""

#. type: Plain text
#: kraft.adoc:142
msgid "image:pdfpostproc.png[PDF Postprocessing,float?\"right\"]"
msgstr ""

#. type: Plain text
#: kraft.adoc:144
msgid "The watermark options are:"
msgstr ""

#. type: Plain text
#: kraft.adoc:146
#, no-wrap
msgid "*No Watermark*: No watermark is created\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:147
#, no-wrap
msgid ""
"*On first page*: The first page of the watermark.pdf is merged with the "
"first page of the result document\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:148
#, no-wrap
msgid ""
"*Watermark on all pages*: Merges the first page of the watermark PDF to all "
"pages of the result document\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:149
#, no-wrap
msgid ""
"*alternating*: For this, the watermark PDF needs to have three pages. The "
"first page is merged to the first page of the result document, the second "
"and third page are alternated merge to subsequent pages.\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:150
#, no-wrap
msgid ""
"*different first and last page*: the PDF needs to have three pages. The "
"first page is merged to the first page of the result document, the third "
"page to the last, and the second to all page between first and last page.\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:152
msgid ""
"If there is another static PDF document put into the entry field \"Append "
"PDF:\", it is appended to the generated PDF. With that, Kraft will "
"automatically add for example terms and conditions documents to the final "
"document."
msgstr ""

#. type: Title ===
#: kraft.adoc:153
#, no-wrap
msgid "Taxes"
msgstr ""

#. type: Plain text
#: kraft.adoc:157
msgid ""
"image:taxes.png[Taxes,float=\"right\"] In many countries there are two kinds "
"of VAT-taxes for sold products."
msgstr ""

#. type: Plain text
#: kraft.adoc:160
msgid "A high level and a low level."
msgstr ""

#. type: Plain text
#: kraft.adoc:163
msgid ""
"Fill here the appropriate amounts in for the high level and the low level.  "
"If the tax-level is changing, then you add here the start date with the new "
"tax-levels."
msgstr ""

#. type: Title ===
#: kraft.adoc:164
#, no-wrap
msgid "Wages"
msgstr ""

#. type: Plain text
#: kraft.adoc:169
msgid ""
"image:wages.png[Wages,float=\"right\"] A list of wage costs is maintained in "
"Kraft. The items are used in templates and during calculation."
msgstr ""

#. type: Plain text
#: kraft.adoc:172
msgid ""
"All data can be edited, customized and new items can be added in the Kraft "
"Configuration Dialog reachable through the Settings menu."
msgstr ""

#. type: Plain text
#: kraft.adoc:176
msgid ""
"Remember that these units are later used in the documents, it is therefor "
"important that you translate them to your own language and to fill in the "
"correct prices."
msgstr ""

#. type: Title ===
#: kraft.adoc:177
#, no-wrap
msgid "Units of measurement"
msgstr ""

#. type: Plain text
#: kraft.adoc:182
msgid ""
"image:unity.png[Units of measurement,float=\"right\"] A list of units of "
"measurement is maintained in Kraft. In Kraft Configuration Dialog reachable "
"through the Settings menu can you edit and customize items already in the "
"list, and also can you add new items to the list."
msgstr ""

#. type: Plain text
#: kraft.adoc:185
msgid ""
"Remember that these units are later used in the documents, it is therefor "
"important that you translate them to your own language."
msgstr ""

#. type: Title ===
#: kraft.adoc:186
#, no-wrap
msgid "Own identity"
msgstr ""

#. type: Plain text
#: kraft.adoc:190
msgid ""
"Check here if the information that you have given during the initial setup "
"is correct for the use in the documents."
msgstr ""

#. type: delimited block _
#: kraft.adoc:195
msgid ""
"WARNING: If you made the choice to use the information from KaddressBook "
"then is the information from a later manual entry ignored."
msgstr ""

#. type: Plain text
#: kraft.adoc:199
msgid ""
"After we have made some corrections to the configuration, we go back to the "
"main window.Here we see three tabs:"
msgstr ""

#. type: Plain text
#: kraft.adoc:201
msgid "Documents"
msgstr ""

#. type: Plain text
#: kraft.adoc:202
msgid "Timeline"
msgstr ""

#. type: Title ==
#: kraft.adoc:203 kraft.adoc:205
#, no-wrap
msgid "Catalogs"
msgstr ""

#. type: Plain text
#: kraft.adoc:208
msgid ""
"Kraft supports so called Catalogs in which templates for document items are "
"kept. With the catalogs creating documents can be significantly accellerated "
"in the day to day business. When creating new documents, the items templates "
"from the catalogs can easily selected and moved over to the document."
msgstr ""

#. type: Plain text
#: kraft.adoc:210
msgid ""
"Since templates are organized in chapters entire documents can be prepared "
"in different chapters to be used as template documents."
msgstr ""

#. type: Plain text
#: kraft.adoc:212
msgid ""
"Of course the items in the documents can be edited after they got picked "
"from a catalog."
msgstr ""

#. type: Plain text
#: kraft.adoc:214
msgid "By default Kraft comes with two different catalogs:"
msgstr ""

#. type: Plain text
#: kraft.adoc:216
msgid "`Material`"
msgstr ""

#. type: Plain text
#: kraft.adoc:219
msgid ""
"A catalog of material that are sold, with their purchase prices, the profit "
"and the sell-price."
msgstr ""

#. type: Plain text
#: kraft.adoc:221
msgid "and `Standard Templates`"
msgstr ""

#. type: Plain text
#: kraft.adoc:223
msgid "A catalog of standard recipes of work like planting trees."
msgstr ""

#. type: Plain text
#: kraft.adoc:226
msgid ""
"Both catalogs can have chapters and sub-chapters for to organize your "
"templates. First we are going to fill in the"
msgstr ""

#. type: Title ===
#: kraft.adoc:227
#, no-wrap
msgid "Material Catalog"
msgstr ""

#. type: Plain text
#: kraft.adoc:232
msgid ""
"A catalog of material that are sold, with their purchase prices, the profit "
"and the sell-price. First we are going to add new chapters and subchapters."
msgstr ""

#. type: Title ====
#: kraft.adoc:233
#, no-wrap
msgid "New chapters"
msgstr ""

#. type: Plain text
#: kraft.adoc:237
msgid ""
"Select with the mouse the column-name `material`, select now in the "
"context-menu [Add a sub chapter]"
msgstr ""

#. type: Plain text
#: kraft.adoc:239
msgid "and add an extra chapter like `Trees`"
msgstr ""

#. type: Title ====
#: kraft.adoc:240
#, no-wrap
msgid "New sub chapters"
msgstr ""

#. type: Plain text
#: kraft.adoc:248
msgid ""
"We are going to ad sub chapters in the map `Trees`. Select with the mouse "
"the name of the chapter where you like to add a subchapter, select now in "
"the context-menu [Add a sub chapter] and ad an extra subchapters like `Loaf "
"trees` and `needle trees`.  After adding the extra chapters and subchapters "
"for dividing the material, we are going to add the material themself."
msgstr ""

#. type: Title ====
#: kraft.adoc:249
#, no-wrap
msgid "New template"
msgstr ""

#. type: Plain text
#: kraft.adoc:254
msgid ""
"Select with the mouse the name of the sub-chapter or chapter where you like "
"to add a material.  Select the sub map Loaf trees and select now in the "
"context-menu"
msgstr ""

#. type: Plain text
#: kraft.adoc:257
msgid "Add the extra materials `coconut tree`, `apple tree` and `pine-apple tree`."
msgstr ""

#. type: Plain text
#: kraft.adoc:259
msgid "Fill in the price that we have paid."
msgstr ""

#. type: Plain text
#: kraft.adoc:261
msgid "Fill in the profit that we want to have on the material"
msgstr ""

#. type: Plain text
#: kraft.adoc:263
msgid "And fill in how much is in a packet."
msgstr ""

#. type: Plain text
#: kraft.adoc:266
msgid ""
"image:catalog_material.png[Material catalog,float=\"right\"] After this we "
"add also in the map 'Wood' a item for a 'support pole' for later use with "
"its price."
msgstr ""

#. type: Plain text
#: kraft.adoc:268
msgid "Now we are going to:"
msgstr ""

#. type: Title ===
#: kraft.adoc:269
#, no-wrap
msgid "Standard Templates"
msgstr ""

#. type: Plain text
#: kraft.adoc:272
msgid "This is a catalog of standard recipes of work like:"
msgstr ""

#. type: Plain text
#: kraft.adoc:274
msgid "planting trees"
msgstr ""

#. type: Plain text
#: kraft.adoc:275
msgid "cutting grass"
msgstr ""

#. type: Plain text
#: kraft.adoc:276
msgid "transport costs"
msgstr ""

#. type: Plain text
#: kraft.adoc:277
msgid "planting grass"
msgstr ""

#. type: Plain text
#: kraft.adoc:278
msgid "sowing grass-seed"
msgstr ""

#. type: Plain text
#: kraft.adoc:280
msgid "We add here the standard work of planting a tree."
msgstr ""

#. type: Plain text
#: kraft.adoc:283
msgid ""
"Select with the mouse the name of the chapter [Work] where you like to add "
"the new template,"
msgstr ""

#. type: Plain text
#: kraft.adoc:285
msgid "select now the context-menu [New template]"
msgstr ""

#. type: Plain text
#: kraft.adoc:287
msgid "and the extra templates `Plant tree` and `cut grass`."
msgstr ""

#. type: Plain text
#: kraft.adoc:289
msgid "After we made the new template, a window opens with 4 tabs:"
msgstr ""

#. type: Title ====
#: kraft.adoc:291 kraft.adoc:297
#, no-wrap
msgid "Template"
msgstr ""

#. type: Title ====
#: kraft.adoc:292 kraft.adoc:309
#, no-wrap
msgid "Time calculation"
msgstr ""

#. type: Plain text
#: kraft.adoc:293
msgid "Fix costs"
msgstr ""

#. type: Title ====
#: kraft.adoc:294 kraft.adoc:346
#, no-wrap
msgid "Material"
msgstr ""

#. type: Plain text
#: kraft.adoc:296
msgid "First we go to the tab:"
msgstr ""

#. type: Plain text
#: kraft.adoc:301
msgid ""
"We give here the name of the new standard template like `Plant tree` "
"image:catalog_standard.png[Standard catalog,float=\"right\"]"
msgstr ""

#. type: delimited block _
#: kraft.adoc:304
msgid "WARNING: be careful, this name is later used in the invoice"
msgstr ""

#. type: Plain text
#: kraft.adoc:308
msgid ""
"we select that this is per piece and that the margin is 8% and that the full "
"VAT is applicable."
msgstr ""

#. type: Plain text
#: kraft.adoc:312
msgid "We fill here in a number of work with the time:"
msgstr ""

#. type: Block title
#: kraft.adoc:313
#, no-wrap
msgid "Spent time"
msgstr ""

#. type: Table
#: kraft.adoc:320
#, no-wrap
msgid ""
"|Dig hole |32 min. |worker\n"
"|Place tree |12 min. |worker\n"
"|Fill hole |17 min. |worker\n"
"|give water |5 min. |worker\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:324
msgid ""
"The cost for worker which we have earlier filled in is now used.  "
"image:catalog_standard_work.png[Time calculation,float=\"right\"]"
msgstr ""

#. type: delimited block _
#: kraft.adoc:328
msgid ""
"NOTE: in the invoice we see later only Plant tree, we will not see the parts "
"dig hole,place tree,fill hole,give water"
msgstr ""

#. type: Plain text
#: kraft.adoc:331
msgid "Now we go to the tab"
msgstr ""

#. type: Title ====
#: kraft.adoc:332
#, no-wrap
msgid "Fixed costs"
msgstr ""

#. type: Plain text
#: kraft.adoc:335
msgid "and fill in:"
msgstr ""

#. type: Block title
#: kraft.adoc:336
#, no-wrap
msgid "Fixed item"
msgstr ""

#. type: Table
#: kraft.adoc:340
#, no-wrap
msgid "|Transportcost |35 euro |1 pcs.\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:343
msgid "image:catalog_standard_fixed_cost.png[Fixed cost,float=\"right\"]"
msgstr ""

#. type: Plain text
#: kraft.adoc:345
msgid "After this we go to the tab:"
msgstr ""

#. type: Plain text
#: kraft.adoc:350
msgid ""
"Here we select btn:[next], after which the window [Add Material to "
"Calculation] opens for a selection of material.  We navigate to the map "
"'wood' where we select the 'support pole'."
msgstr ""

#. type: Block title
#: kraft.adoc:351
#, no-wrap
msgid "Used materials"
msgstr ""

#. type: Table
#: kraft.adoc:355
#, no-wrap
msgid "|1 |support pole |3,5 euro\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:358
msgid "image:catalog_standard_material.png[Material,float=\"right\"]"
msgstr ""

#. type: Plain text
#: kraft.adoc:360
msgid "We go now back to the first tab template"
msgstr ""

#. type: Plain text
#: kraft.adoc:363
msgid "On the first tab [template], we can now see the overall cost per one unit"
msgstr ""

#. type: Plain text
#: kraft.adoc:366
msgid ""
"Click on [OK] for saving the result or on [cancel] for discarding the "
"result."
msgstr ""

#. type: Plain text
#: kraft.adoc:368
msgid "We make a second template `cut grass`"
msgstr ""

#. type: Plain text
#: kraft.adoc:371
msgid ""
"we fill in `cut grass`, as unit we choose sm (square meter), on the second "
"tab we fill in that we need 3 min per square meter."
msgstr ""

#. type: Plain text
#: kraft.adoc:374
msgid ""
"Click on [OK] for saving the result or on [Cancel] for discarding the "
"result."
msgstr ""

#. type: Plain text
#: kraft.adoc:376
msgid "'''"
msgstr ""

#. type: Title ===
#: kraft.adoc:377
#, no-wrap
msgid "Header- and Footer Text Templates"
msgstr ""

#. type: Plain text
#: kraft.adoc:380
msgid ""
"Kraft supports text templates also for the header- and footer-text of "
"documents. Each document type has it's own set of text templates. To access "
"them, open a document of a certain document type in edit mode and use the "
"btn:[show templates] to make the templates visible. In both the header- and "
"footer-section the stored templates become visible."
msgstr ""

#. type: Plain text
#: kraft.adoc:382
msgid ""
"Directly under the navigation pane on the right side of the window is a list "
"of the names of the available templates. Clicking on one of the names in the "
"list displays the text in the pane below."
msgstr ""

#. type: Plain text
#: kraft.adoc:384
msgid ""
"Underneath there are buttons located with the following functions from left "
"to right:"
msgstr ""

#. type: Plain text
#: kraft.adoc:386
msgid ""
"Add the template to the document: This button replaces the text of the "
"document with the selected template."
msgstr ""

#. type: Plain text
#: kraft.adoc:387
msgid ""
"Insert the template to the document: The selected template is inserted to "
"the current place of the cursor in the document."
msgstr ""

#. type: Plain text
#: kraft.adoc:388
msgid ""
"Create a new template: Opens a dialog to enter a complete new template for "
"the current doc type."
msgstr ""

#. type: Plain text
#: kraft.adoc:389
msgid ""
"Edit the current template: Opens the dialog to edit the currently selected "
"template."
msgstr ""

#. type: Plain text
#: kraft.adoc:390
msgid ""
"Delete the current template: Removes the template permanently from the list "
"of available templates."
msgstr ""

#. type: Plain text
#: kraft.adoc:392
msgid ""
"Templates with the name _Standard_ are the default templates for the "
"document type. They are inserted automatically if a document of this type is "
"created."
msgstr ""

#. type: Title ====
#: kraft.adoc:394
#, no-wrap
msgid "Macros"
msgstr ""

#. type: Plain text
#: kraft.adoc:397
msgid ""
"Both the header- and footer-templates can contain so called macros which are "
"replaced with calculated values once the document is rendered to the final "
"output format."
msgstr ""

#. type: Plain text
#: kraft.adoc:399
msgid "The following list of macros are supported:"
msgstr ""

#. type: Plain text
#: kraft.adoc:401
msgid ""
"`DATE_ADD_DAYS(<amount_days>)`: Returns the date of the of document plus the "
"number of days specified as parameter to the macro."
msgstr ""

#. type: Plain text
#: kraft.adoc:402
msgid ""
"`ITEM_COUNT_WITH_TAG(<tag>)`: Returns the amount of items tagged with the "
"tag."
msgstr ""

#. type: Plain text
#: kraft.adoc:403
msgid ""
"`NETTO_SUM_PER_TAG(<tag>)`: Returns the netto sum of all items that are "
"tagged with the named tag."
msgstr ""

#. type: Plain text
#: kraft.adoc:404
msgid ""
"`BRUTTO_SUM_PER_TAG(<tag>)`: Returns the brutto sum of all items that are "
"tagged with the named tag."
msgstr ""

#. type: Plain text
#: kraft.adoc:405
msgid ""
"`VAT_SUM_PER_TAG(<tag>)`: Returns the pure tax of all items that are tagged "
"with the named tag."
msgstr ""

#. type: Plain text
#: kraft.adoc:406
msgid ""
"`IF_ANY_HAS_TAG(<tag>)` and `END_HAS_TAG`: Includes the text between the two "
"macros only if there is at least one item that is tagged with the tag."
msgstr ""

#. type: Plain text
#: kraft.adoc:408
msgid ""
"As an example, this footer text template can be used to automatically "
"generate useful texts:"
msgstr ""

#. type: Plain text
#: kraft.adoc:411
msgid ""
"``` Please pay this invoice until three weeks after the date of the "
"document, which is the DATE_ADD_DAYS(21)."
msgstr ""

#. type: Plain text
#: kraft.adoc:417
msgid ""
"IF_ANY_HAS_TAG(Material)  This invoice lists material in "
"ITEM_COUNT_WITH_TAG(Material) items. The net value is "
"NETTO_SUM_PER_TAG(Material), plus VAT_SUM_PER_TAG(Material) = "
"BRUTTO_SUM_PER_TAG(Material).  END_HAS_TAG ```"
msgstr ""

#. type: Plain text
#: kraft.adoc:419
msgid "We are now ready for the first invoice."
msgstr ""

#. type: Title ==
#: kraft.adoc:421
#, no-wrap
msgid "Creating Documents"
msgstr ""

#. type: Title ===
#: kraft.adoc:423
#, no-wrap
msgid "The first Invoice"
msgstr ""

#. type: Plain text
#: kraft.adoc:426
msgid "Open the tab btn:[documents]"
msgstr ""

#. type: Plain text
#: kraft.adoc:428 kraft.adoc:533
msgid "Click on btn:[create document]"
msgstr ""

#. type: Plain text
#: kraft.adoc:430
msgid "The window document [creation wizard opens]."
msgstr ""

#. type: Plain text
#: kraft.adoc:432
msgid "Select in document type `invoice`."
msgstr ""

#. type: Plain text
#: kraft.adoc:435
msgid ""
"Fill in on the whiteboard content a short text about what the invoice is, "
"like: `cut grass and planted tree for mister Jonson`"
msgstr ""

#. type: Plain text
#: kraft.adoc:437 kraft.adoc:542
msgid "Click on btn:[next]"
msgstr ""

#. type: Plain text
#: kraft.adoc:439 kraft.adoc:544
msgid "Select on the new window the name and address from the client."
msgstr ""

#. type: Plain text
#: kraft.adoc:442 kraft.adoc:547
msgid ""
"(if the name and address is not there, click then on btn:[new contact] or on "
"btn:[edit contact] if you want to edit the contact)"
msgstr ""

#. type: Plain text
#: kraft.adoc:444 kraft.adoc:549
msgid "Click on btn:[OK]."
msgstr ""

#. type: Plain text
#: kraft.adoc:446
msgid "Now opens the window document [items]."
msgstr ""

#. type: Plain text
#: kraft.adoc:448
msgid "this window has 2 tabs and the 3 buttons on the top:"
msgstr ""

#. type: Plain text
#: kraft.adoc:450 kraft.adoc:555
msgid "btn:[Add item...],"
msgstr ""

#. type: Plain text
#: kraft.adoc:451 kraft.adoc:556
msgid "btn:[Add discount item],"
msgstr ""

#. type: Plain text
#: kraft.adoc:452 kraft.adoc:557
msgid "btn:[Show templates]."
msgstr ""

#. type: Plain text
#: kraft.adoc:456
msgid ""
"In the left tab you can see all the items that we want to place on the "
"invoice, on the right tab we see the text from the header, the total price "
"and the footer."
msgstr ""

#. type: Plain text
#: kraft.adoc:460
msgid ""
"If you click on the text of the header or the footer on the right side then "
"the window changes in such a way that you can edit the header or the footer."
msgstr ""

#. type: Plain text
#: kraft.adoc:463
msgid ""
"Adapt the header and the footer to your situation, on the footer you can "
"place a text: `We make your garden-dream come to reality.`."
msgstr ""

#. type: Plain text
#: kraft.adoc:465 kraft.adoc:559
msgid "Click on the button btn:[Show templates]."
msgstr ""

#. type: Plain text
#: kraft.adoc:469
msgid ""
"The right tab changes and show now the earlier made templates, we select in "
"the group Work, the subgroup Plant tree and click then on the button with "
"the to the left pointing arrow on the bottom side."
msgstr ""

#. type: Plain text
#: kraft.adoc:471 kraft.adoc:565
msgid "A new window [Create Item from Template] opens."
msgstr ""

#. type: Plain text
#: kraft.adoc:474
msgid ""
"Because we have planted 2 trees, we go to the field [insert] and change this "
"to 2 pcs."
msgstr ""

#. type: Plain text
#: kraft.adoc:477
msgid ""
"Click on btn:[OK] for saving the result or on btn:[cancel] for discarding "
"the result."
msgstr ""

#. type: Plain text
#: kraft.adoc:479 kraft.adoc:573 kraft.adoc:584
msgid "The window close and we go back to the main window."
msgstr ""

#. type: Plain text
#: kraft.adoc:483
msgid ""
"We click again on btn:[Show templates] and select this time `cut grass`, we "
"click again on the button with the arrow, in the opened window we select "
"that the grass-field was 24 square meter."
msgstr ""

#. type: Plain text
#: kraft.adoc:486 kraft.adoc:571 kraft.adoc:604 kraft.adoc:640
msgid ""
"Click on btn:[OK] for saving the result or on btn:[Cancel] for discarding "
"the result."
msgstr ""

#. type: Plain text
#: kraft.adoc:488
msgid ""
"We add now manually an item by clicking on the button btn:[Add itemâ¦] and "
"the window [create new item] opens."
msgstr ""

#. type: Plain text
#: kraft.adoc:492
msgid ""
"Because we have delivered a special tree, we fill here in the name of the "
"special tree `liguster`, at the field insert we fill in the number of the "
"special trees that we have delivered and the price of them."
msgstr ""

#. type: delimited block _
#: kraft.adoc:498
msgid ""
"WARNING: Remind that in the catalog we can add a profit on the price of the "
"material, in the invoice and in the offer we can not add a profit on the "
"price of the material."
msgstr ""

#. type: Plain text
#: kraft.adoc:501
msgid "We have now an invoice with 3 items."
msgstr ""

#. type: Plain text
#: kraft.adoc:504
msgid ""
"Click on btn:[OK] for saving the invoice or on btn:[Cancel] for discarding "
"the invoice."
msgstr ""

#. type: Plain text
#: kraft.adoc:506
msgid "We click on btn:[OK] and save the result."
msgstr ""

#. type: Plain text
#: kraft.adoc:508
msgid "Your first invoice is now ready for sending."
msgstr ""

#. type: Plain text
#: kraft.adoc:511
msgid ""
"In the window documents we see our first invoice, notice that this document "
"has a document number which we can see on the left side."
msgstr ""

#. type: Plain text
#: kraft.adoc:514
msgid ""
"On top of the window with all the invoices we see the button [Print "
"Document], on which we click."
msgstr ""

#. type: Plain text
#: kraft.adoc:517
msgid ""
"From the invoice will now a PDF be made which we can print on paper or send "
"by email to the client."
msgstr ""

#. type: Plain text
#: kraft.adoc:519
msgid "After this we are going to create a offer for some work in a garden."
msgstr ""

#. type: Title ===
#: kraft.adoc:521
#, no-wrap
msgid "Creating an Offer"
msgstr ""

#. type: Plain text
#: kraft.adoc:524
msgid ""
"The client has asked to plant a tree, we will offer 3 different trees which "
"we can plant."
msgstr ""

#. type: Plain text
#: kraft.adoc:527
msgid ""
"Beside this, we have seen that there is a lifeless three, which we will "
"offer to remove as extra work.  "
"image:create_new_doc.png[Numbercycles,float=\"right\"]"
msgstr ""

#. type: Plain text
#: kraft.adoc:529
msgid ""
"For the total price we do not want to show the price of the removal of the "
"lifeless tree and we want for the total price only to show the price of one "
"tree and not three."
msgstr ""

#. type: Plain text
#: kraft.adoc:531
msgid "Open again the tab btn:[documents]."
msgstr ""

#. type: Plain text
#: kraft.adoc:535
msgid "The window _Document Creation Wizard_ opens."
msgstr ""

#. type: Plain text
#: kraft.adoc:537
msgid "select in btn:[document type] > btn:[Offer]."
msgstr ""

#. type: Plain text
#: kraft.adoc:540
msgid ""
"Fill in on the whiteboard content a short text about what the offer is, "
"like: `plant one tree and removal of lifeless tree`"
msgstr ""

#. type: Plain text
#: kraft.adoc:551
msgid "Now the window [edit document] opens."
msgstr ""

#. type: Plain text
#: kraft.adoc:553
msgid "This window has 2 tabs and the 3 buttons on the top:"
msgstr ""

#. type: Plain text
#: kraft.adoc:563
msgid ""
"The right tab changes and show now the earlier made templates, we select in "
"the group `Work`, the subgroup `Plant tree` and click then on the button "
"with the to the left pointing arrow on the bottom side."
msgstr ""

#. type: Plain text
#: kraft.adoc:568
msgid ""
"Because we want to plant 1 tree, we go to the field [insert] and keep this "
"on 1 pcs."
msgstr ""

#. type: Plain text
#: kraft.adoc:576
msgid ""
"We click on the button btn:[Show templates] and this time we select in "
"catalog Material"
msgstr ""

#. type: Plain text
#: kraft.adoc:580
msgid ""
"The material-catalog opens, and we can select in the chapter `trees` the "
"subchapter `loaf trees` in which we select the `apple tree` which we made "
"earlier."
msgstr ""

#. type: Plain text
#: kraft.adoc:582
msgid ""
"Click on we btn:[OK] for saving the result or on btn:[cancel] for discarding "
"the result."
msgstr ""

#. type: Plain text
#: kraft.adoc:586
msgid "We add now manually an item by clicking on the button `Add itemâ¦`."
msgstr ""

#. type: Plain text
#: kraft.adoc:588
msgid "the window [create new item] opens."
msgstr ""

#. type: Plain text
#: kraft.adoc:590
msgid ""
"We want that the client can make a choice from an apple, a pear tree and the "
"liguster."
msgstr ""

#. type: Plain text
#: kraft.adoc:592
msgid "Therefor we are going to add also a pear tree manually."
msgstr ""

#. type: Plain text
#: kraft.adoc:594
msgid ""
"We click on the button btn:[Add itemâ¦] and the window [create new item] "
"opens."
msgstr ""

#. type: Plain text
#: kraft.adoc:598
msgid ""
"We fill here in the name of the tree `Pear tree`, at the field insert we "
"fill in the number of the special trees that we have delivered and the price "
"of them."
msgstr ""

#. type: Plain text
#: kraft.adoc:601
msgid ""
"We want add this to the material catalog for future use, therefor we select "
"also [select this item as template for future documents] and we select in "
"[save in chapter]`trees`."
msgstr ""

#. type: Plain text
#: kraft.adoc:606
msgid "We does this again but then for the liguster."
msgstr ""

#. type: Plain text
#: kraft.adoc:608
msgid "We have now 3 items with trees in the offer."
msgstr ""

#. type: Plain text
#: kraft.adoc:610
msgid "As last item we add an item with `remove tree` with 0,5 hour for 32 euro."
msgstr ""

#. type: Plain text
#: kraft.adoc:612
msgid "On the left side of an item we can see 2 buttons:"
msgstr ""

#. type: Plain text
#: kraft.adoc:614
msgid "a button with a flag and a button with what looks like a page."
msgstr ""

#. type: Plain text
#: kraft.adoc:617
msgid ""
"We select the upper button with the page after which opens a context-menu "
"with the items:"
msgstr ""

#. type: Plain text
#: kraft.adoc:619
msgid "image:context1.png[Context menu,float=\"right\"]"
msgstr ""

#. type: Plain text
#: kraft.adoc:629
#, no-wrap
msgid ""
" [Item kind]->[Normal]\n"
" [Item kind]>[Alternative]\n"
" [Item kind]>[On demand]\n"
" [Tax]\n"
" [Move up]\n"
" [Move down]\n"
" [Lock item]\n"
" [Unlock item]\n"
" [Delete item]\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:632
msgid ""
"We choose here [Item kind] and change for `pear tree` from [normal] to "
"[alternative]."
msgstr ""

#. type: Plain text
#: kraft.adoc:635
msgid ""
"We do this also for [liguster] and for [remove tree] we change this from "
"[normal] to [on demand]."
msgstr ""

#. type: Plain text
#: kraft.adoc:637
msgid "image:context2.png[Context menu,float=\"right\"]"
msgstr ""

#. type: Plain text
#: kraft.adoc:643
msgid ""
"We want to see the result and therefor we click on the button [show "
"document]."
msgstr ""

#. type: Plain text
#: kraft.adoc:649
msgid ""
"We see now that the prize of the pear tree, the liguster and the removal of "
"the tree is not used for the total prize. When we are happy with the result, "
"we can click on the button btn:[close] after which we click on the button "
"btn:[Print Document] for making a PDF what we can print out or send to the "
"client."
msgstr ""

#. type: Plain text
#: kraft.adoc:652
msgid "After your first invoice is now your first offer now also ready for sending."
msgstr ""

#. type: Title ===
#: kraft.adoc:654
#, no-wrap
msgid "Creating an Acceptance of Order"
msgstr ""

#. type: Plain text
#: kraft.adoc:657
msgid "The document type \"Acceptance of Order\" is sent subsequently to an offer."
msgstr ""

#. type: Plain text
#: kraft.adoc:659
msgid "image:acceptance_o_o_context.png[Numbercycles,float=\"right\"]"
msgstr ""

#. type: Plain text
#: kraft.adoc:662
msgid ""
"When a client has made a request, we will send an offer in wich we describe "
"which items we will deliver.  Hopefully the client will give an order for "
"the work."
msgstr ""

#. type: Plain text
#: kraft.adoc:666
msgid ""
"It is a good practice to respond on the order with an \"Acceptance of "
"order\" in which we describe all the items we will deliver.  We can make the "
"\"Acceptance of order\" on the same way as we made the invoice or the offer "
"by selecting each item and correcting the number of delivery.  This takes "
"time and we can make errors by forgetting items or filling an incorrect "
"number."
msgstr ""

#. type: Plain text
#: kraft.adoc:668
msgid ""
"It can be done quicker by selecting the offer in the list and selecting "
"btn:[Create Followup Document] from either the context menu or the main "
"menu."
msgstr ""

#. type: Plain text
#: kraft.adoc:670
msgid "We have now in documenttype the choice from:"
msgstr ""

#. type: Plain text
#: kraft.adoc:676
#, no-wrap
msgid ""
" [Acceptance of order]\n"
" [Invoice]\n"
" [Partial Invoice]\n"
" [final Invoice]\n"
" [Progress Payment Invoice]\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:678
msgid "image:followup_1.png[Folloup document,float=\"right\"]"
msgstr ""

#. type: Plain text
#: kraft.adoc:682
msgid ""
"We select here \"Acceptance of order\".  We have now a copy from the offer "
"as an Acceptance of order (do not forget to adapt Alternative Delivery items "
"and on demand items.)"
msgstr ""

#. type: Plain text
#: kraft.adoc:684
msgid "image:followup_2.png[Folloup document,float=\"right\"]"
msgstr ""

#. type: Plain text
#: kraft.adoc:688
msgid ""
"You can do this also for the creation of the invoice as a followup for "
"Acceptance of order.  Each document type has a specific list of follow up "
"documents.  It is a good practice to describe on the invoice precisely what "
"was delivered."
msgstr ""

#. type: Title ==
#: kraft.adoc:690
#, no-wrap
msgid "Customization"
msgstr ""

#. type: Plain text
#: kraft.adoc:694
msgid ""
"Kraft can be customized in most of the graphical user interface and in "
"particular in the output it generates."
msgstr ""

#. type: Title ===
#: kraft.adoc:695
#, no-wrap
msgid "Output Document Customization"
msgstr ""

#. type: Plain text
#: kraft.adoc:698
msgid ""
"To create PDF output documents, the document data that was edited in the "
"Kraft app is filled into a template. The template defines how the output "
"document looks like, ie. by font settings, placing of elements and such."
msgstr ""

#. type: Plain text
#: kraft.adoc:700
msgid ""
"The file that is assembled from data and the template is converted to PDF "
"using a special document creation script. All that is started automatically "
"by Kraft if a document should be printed."
msgstr ""

#. type: Plain text
#: kraft.adoc:702
msgid ""
"Each document type in Kraft can have it's own template that is used to "
"create a PDF. Which one can be set in the Settings dialog for document "
"types."
msgstr ""

#. type: Title ====
#: kraft.adoc:703
#, no-wrap
msgid "WeasyPrint Documents"
msgstr ""

#. type: Plain text
#: kraft.adoc:706
msgid ""
"Kraft still ships with the old ReportLab based converter, but that will be "
"deprecated the future. The WeasyPrint based system is the future. It is a "
"recommended to port existing templates."
msgstr ""

#. type: Plain text
#: kraft.adoc:708
msgid ""
"With https://weasyprint.org[WeasyPrint] Kraft uses a very powerful generator "
"that makes it very easy to create highly customized documents with great "
"quality."
msgstr ""

#. type: Plain text
#: kraft.adoc:710
msgid ""
"WeasyPrint converts a html file to PDF. It is integrating a cascading "
"stylesheet (CSS) file which has a huge impact on the PDF document's look."
msgstr ""

#. type: Plain text
#: kraft.adoc:712
msgid ""
"The html- and CSS input file for WeasyPrint is built from the Kraft template "
"file."
msgstr ""

#. type: Plain text
#: kraft.adoc:714
msgid ""
"To enable the use of WeasyPrint for a document type in Kraft, simply create "
"a weasyprint compatible template file and save it with the extension "
"*.gtmpl*. Based on the file extension Kraft automatically uses WeasyPrint "
"and the Grantlee templating engine for rendering."
msgstr ""

#. type: Plain text
#: kraft.adoc:716
msgid ""
"From version 0.95 on Kraft ships with an example template in the Grantlee- "
"and WeasyPrint format. It can be found at "
"`/usr/share/kraft/reports/invoice.gtmpl` or "
"https://github.com/dragotin/kraft/blob/master/reports/invoice.gtmpl[online "
"on Github]. An example CSS file `kraft.css` "
"(https://github.com/dragotin/kraft/blob/master/reports/kraft.css[on Github]) "
"is shipped as a good starting point for adoption."
msgstr ""

#. type: Title ====
#: kraft.adoc:717
#, no-wrap
msgid "Template Variables"
msgstr ""

#. type: Plain text
#: kraft.adoc:720
msgid ""
"To generate the PDF, Kraft has to transfer data from the document you have "
"been working on to the input file that is processed to a PDF. For that, "
"Kraft uses a text template in which Kraft replaces variables with the actual "
"values."
msgstr ""

#. type: Plain text
#: kraft.adoc:722
msgid ""
"For example, the tag `{{ doc.doctype }}` is replaced with the current "
"document type during the generating process."
msgstr ""

#. type: Plain text
#: kraft.adoc:724
msgid ""
"The syntax is based on the Django syntax for templates described in the "
"https://docs.djangoproject.com/en/3.1/topics/templates/[the docs]."
msgstr ""

#. type: Title ====
#: kraft.adoc:725
#, no-wrap
msgid "EPC QR Code"
msgstr ""

#. type: Plain text
#: kraft.adoc:728
msgid ""
"With Weasyprint based PDF generation Kraft supports the "
"https://en.wikipedia.org/wiki/EPC_QR_code[EPC QR Code] which implements a "
"European standard for payments by computer and mobile devices."
msgstr ""

#. type: Plain text
#: kraft.adoc:730
msgid ""
"In Germany it is also known as _Giro Code_, in Belgium as _Bancontact QR_, "
"in the Netherlands as _iDEAL QR-code_ and in Spain it is also known as "
"_Bizum QR-code_."
msgstr ""

#. type: Plain text
#: kraft.adoc:732
msgid ""
"In Germany it is accepted by the _Giro Code_ and in Holland it is accepted "
"by the official https://www.ideal.nl/consumenten/ideal-app/[_iDEAL QR-code_] "
"app."
msgstr ""

#. type: Plain text
#: kraft.adoc:734
msgid ""
"In Belgium and Holland it is accepted by the apps of many banks, and in "
"Austria and Finland it is accepted by the apps of all banks."
msgstr ""

#. type: Plain text
#: kraft.adoc:736
msgid ""
"To use the EPC QR code on the invoice printout, the bank account information "
"has to be added to own identity settings dialog in Kraft. The giro code is "
"current only generated for documents with the document type `Rechnung`."
msgstr ""

#. type: Plain text
#: kraft.adoc:738
msgid ""
"To include the generated EPC QR Code into the PDF document, the Weasyprint "
"template needs to contain a snippet like this:"
msgstr ""

#. type: Plain text
#: kraft.adoc:748
#, no-wrap
msgid ""
"```\n"
"    {%if doc.isInvoice and epcqrcode.valid %}\n"
"    <p class=\"epcqrcode\">\n"
"      <img class=\"epc\" src=\"file://{{ epcqrcode.svgfilename }}\" "
"alt=\"EPC QR Code\" />\n"
"      Dieser QR Code ermÃ¶glicht einfaches, sicheres und schnelles "
"Begleichen dieser Rechnung via GiroPay:\n"
"      Diesen Code mit dem Smartphone scannen und Ãberweisung per Banking "
"App aufgeben.\n"
"    </p>\n"
"    {% endif %}\n"
"```\n"
msgstr ""

#. type: Title ==
#: kraft.adoc:751
#, no-wrap
msgid "Menus and Shortcuts"
msgstr ""

#. type: Title ===
#: kraft.adoc:753
#, no-wrap
msgid "Main Application Menu"
msgstr ""

#. type: Title ====
#: kraft.adoc:756
#, no-wrap
msgid "The File Menu"
msgstr ""

#. type: Plain text
#: kraft.adoc:761
#, no-wrap
msgid ""
" [File]>[Quit]\n"
" [Ctrl]+[Q]\n"
" Quits the application.\n"
msgstr ""

#. type: Title ====
#: kraft.adoc:763
#, no-wrap
msgid "The Document Menu"
msgstr ""

#. type: Plain text
#: kraft.adoc:769
#, no-wrap
msgid ""
" [Document]>[Show Document]\n"
" [Ctrl]+[R]\n"
" Opens a window with the selected document for showing it.\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:773
#, no-wrap
msgid ""
" [Document]>[Edit Document]\n"
" [Ctrl+O]\n"
" Opens a window with the selected document for editing it.\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:777
#, no-wrap
msgid ""
" [Document]>[Open Archived document]\n"
" [Ctrl]+[A]\n"
" Opens an archived document.\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:780
#, no-wrap
msgid ""
" [Document]>[Create Document]\n"
" Opens a window with a wizard for creating a new client-document.\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:784
#, no-wrap
msgid ""
" [Document]>[Copy Document]\n"
" Makes a copy of the selected client-document to a new client-document\n"
" which can belong to an other client or an other documenttype.\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:787
#, no-wrap
msgid ""
" [Document]>[Follow Document]\n"
" Opens the selected client-document for editing.\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:791
#, no-wrap
msgid ""
" [Document]>[Print document]\n"
" Makes a PDf from the selected client-document for to be mailed or\n"
" printed.\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:795
#, no-wrap
msgid ""
" [Document]>[Mail document]\n"
" [Ctrl]+[M]\n"
" Mails a document.\n"
msgstr ""

#. type: Title ====
#: kraft.adoc:798
#, no-wrap
msgid "The Settings menu"
msgstr ""

#. type: Plain text
#: kraft.adoc:804
#, no-wrap
msgid ""
" [Settings]>[Edit Tag Templates]\n"
" [Ctrl]+[E]\n"
" Opens a window where you add, edit or translate the tags (like work,\n"
" material, plants or discounts).\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:808
#, no-wrap
msgid ""
" [Settings]>[Redo initial setup]\n"
" [Ctrl+R]\n"
" Redoes the initial setup. After this, a restart of Kraft is required.\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:812
#, no-wrap
msgid ""
" [Settings]>[Showed toolbars]\n"
" Here you can decide if the `main toolbar` and the toolbar `Document "
"Actions`\n"
" are shown.\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:816
#, no-wrap
msgid ""
" [Settings]>[Configure Kraft]\n"
" [Ctrl]+[Shft]+[,]\n"
" Here you can configure Kraft.\n"
msgstr ""

#. type: Title ===
#: kraft.adoc:817
#, no-wrap
msgid "Document Edit Window"
msgstr ""

#. type: Title ====
#: kraft.adoc:820
#, no-wrap
msgid "The context Menu"
msgstr ""

#. type: Plain text
#: kraft.adoc:824
#, no-wrap
msgid ""
" [Context]>[Item kind]\n"
" change the status from this item between\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:825
#, no-wrap
msgid "Normal\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:826
#, no-wrap
msgid "Alternative\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:827
#, no-wrap
msgid "On demand\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:830
#, no-wrap
msgid ""
" [Context]>[Tax]\n"
" Seems not working.\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:833
#, no-wrap
msgid ""
" [Context]>[Move up]\n"
" Moves this item a place up in document.\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:836
#, no-wrap
msgid ""
" [Context]>[Move down]\n"
" Moves this item a place down in document.\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:839
#, no-wrap
msgid ""
" [Context]>[Lock item]\n"
" It is not clear what is does.\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:842
#, no-wrap
msgid ""
" [Context]>[Unlock item]\n"
" It is not clear what is does.\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:845
#, no-wrap
msgid ""
" [Context]>[Delete item]\n"
" Removes this item from document.\n"
msgstr ""

#. type: Title ==
#: kraft.adoc:848
#, no-wrap
msgid "Advanced Topics"
msgstr ""

#. type: Plain text
#: kraft.adoc:851
msgid ""
"This chapter describes advanced topics around Kraft. Some Linux knowledge is "
"required, and setups should be done by experienced Linux administrators and "
"should be tested carefully."
msgstr ""

#. type: Title ===
#: kraft.adoc:852
#, no-wrap
msgid "Using Kraft Collaboratively"
msgstr ""

#. type: Plain text
#: kraft.adoc:855
msgid ""
"Kraft can be used collaborative in a distributed environment. That means "
"that multiple users work on their desktops with their own Kraft instance on "
"the same data."
msgstr ""

#. type: Plain text
#: kraft.adoc:857
msgid ""
"This whole topic is a subject to change, as Kraft will evolve to use "
"ownCloud as a private cloud solution to store the data."
msgstr ""

#. type: Title ====
#: kraft.adoc:858
#, no-wrap
msgid "Sharing Database and Document Pool"
msgstr ""

#. type: Plain text
#: kraft.adoc:861
msgid ""
"The simplest case is that two or more Kraft instances use a database "
"together and access the same pool of PDF documents on the harddisk. For "
"simplicity this describes only two Kraft instances."
msgstr ""

#. type: Plain text
#: kraft.adoc:863
msgid ""
"A typical use case would be: Two different Linux users want to use "
"Kraft. They both have their own computer but only work in the same "
"network. For example this would describe a situation with one main office "
"machine that runs Kraft in normal mode, plus a notebook with Kraft in read "
"only mode to view documents, check catalogs and such."
msgstr ""

#. type: Plain text
#: kraft.adoc:865
msgid "For that, the following prerequisites have to be met:"
msgstr ""

#. type: Plain text
#: kraft.adoc:867
msgid "MySQL or MariaDB is used as database backend. Sqlite is not supported."
msgstr ""

#. type: Plain text
#: kraft.adoc:868
msgid ""
"The database is accessible with a mysql user and from each machine for both "
"users."
msgstr ""

#. type: Plain text
#: kraft.adoc:869
msgid "The document store directory has to be shared."
msgstr ""

#. type: delimited block _
#: kraft.adoc:873
msgid ""
"WARNING: There is no protection against having both users editing the same "
"document. Because that is dangerous and can lead to unpredictable results, "
"it is recommended to run all instances of Kraft except the main one in read "
"only mode. This is done by starting Kraft with the `-r` command line switch."
msgstr ""

#. type: Plain text
#: kraft.adoc:876
#, no-wrap
msgid "**Sharing the Database**\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:878
msgid ""
"The database server should be installed on the main machine or a dedicated "
"device like a NAS. Networking speed influences the comfort to use obviously."
msgstr ""

#. type: Plain text
#: kraft.adoc:880
msgid "Find howtos on the internet how to setup MySQL accordingly."
msgstr ""

#. type: Plain text
#: kraft.adoc:882
#, no-wrap
msgid "**Sharing the Document Pool Directory**\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:884
msgid ""
"Kraft writes generated PDF documents into a local directory. Where that is "
"can be configured in the Kraft Config file. The config file has to be "
"adopted on all instances."
msgstr ""

#. type: Plain text
#: kraft.adoc:886
msgid ""
"That is located in each users home directory, in the path "
"`.config/kraftrc`. It has to contain the following config value:"
msgstr ""

#. type: Plain text
#: kraft.adoc:888 kraft.adoc:892
msgid "```"
msgstr ""

#. type: Plain text
#: kraft.adoc:890
msgid "PdfOutputDir=/data/space/kraftdoc/pdf"
msgstr ""

#. type: Plain text
#: kraft.adoc:894
msgid ""
"There are different ways how share that directory, ie. NFS or SMB "
"storages. It is important that both users from both machines can list and "
"access the files. The main user needs read and write access, read only users "
"only need read access to the files."
msgstr ""

#. type: Plain text
#: kraft.adoc:896
msgid ""
"A recommended setup is a NFS share with autofs which is set up on the main "
"machine. To manage file access a certain group should be set up on the "
"machines with which access can be managed."
msgstr ""

#. type: Plain text
#: kraft.adoc:898
#, no-wrap
msgid "**Starting Kraft in read-only mode**\n"
msgstr ""

#. type: Plain text
#: kraft.adoc:900
msgid ""
"To start Kraft in read-only mode, start the binary with the `-r` command "
"line switch."
msgstr ""

#. type: Title ===
#: kraft.adoc:901
#, no-wrap
msgid "XRechnung Support"
msgstr ""

#. type: Plain text
#: kraft.adoc:904
msgid ""
"Kraft supports the XRechnung standard. That is a digital format for "
"electronic invoicing, and it passed as law in Germany and follows a EU "
"directive. The XRechnung is a XML file format designed for that purpose."
msgstr ""

#. type: Plain text
#: kraft.adoc:906
msgid ""
"To use the XRechnung Export productivly, a little manual work is still "
"needed in Kraft. Kraft creates the XML file based on a template, very "
"similar to the normal PDF documents. That means that it loads a template "
"that contains static elements (ie. the company address) that do not change "
"between different invoices. The dynamic elements (customer data, items etc.) "
"are filled into the template during the generation step."
msgstr ""

#. type: Plain text
#: kraft.adoc:908
msgid ""
"In order to generate correct XRechnung files for the specific company, the "
"user has to adopt the template file manually to the companies needs. Note "
"that this has only to be done once and should be easy for a person with a "
"bit computer experience (Basic knowledge about XML appreciated!)."
msgstr ""

#. type: Plain text
#: kraft.adoc:910
msgid ""
"To adapt the file to the needs of the company, it is best to start with the "
"https://raw.githubusercontent.com/dragotin/kraft/master/reports/xrechnung.xrtmpl[example "
"XRechnung file]. It has to be downloaded and saved into a location that the "
"user can edit. Open it in a normal text editor, such as "
"https://kate-editor.org/[Kate]."
msgstr ""

#. type: Plain text
#: kraft.adoc:912
msgid ""
"Read carefully through the file without being scared off by the XML "
"format. All user strings (ie. company name, address and such) are user "
"specific and should be replaced accordingly. Find "
"https://www.xoev.de/xrechnung-16828[details about the format] here to better "
"understand the meaning of the fields."
msgstr ""

#. type: Plain text
#: kraft.adoc:914
msgid ""
"Make sure to not disturb the proper XML format and do not change places "
"where the template format `{{ template_name }}` is used."
msgstr ""

#. type: Plain text
#: kraft.adoc:916
msgid ""
"Once the file is adopted to the needs, open the Settings dialog of Kraft and "
"insert the filename into the entry field for the XRechnung Template File on "
"the Document Defaults page."
msgstr ""

#. type: Plain text
#: kraft.adoc:918
msgid ""
"After that step, the btn:[Export XRechung] menu item will open a dialog to "
"pick a filename where to save the XRechnung invoice to."
msgstr ""

#. type: Plain text
#: kraft.adoc:920
msgid "This file can now be transfered to the receiver of the invoice."
msgstr ""

#. type: Plain text
#: kraft.adoc:922
msgid ""
"There are validators for invoices in XRechnung format out there in the "
"internet. It is useful to verify the format of the Kraft exported XRechnung."
msgstr ""

#. type: Title ===
#: kraft.adoc:923
#, no-wrap
msgid "Changing the Locale"
msgstr ""

#. type: Plain text
#: kraft.adoc:926
msgid ""
"If it is needed that Kraft runs under a different locale than the actual "
"desktop environment, this can be achieved by setting the desired locale in "
"the start file of Kraft."
msgstr ""

#. type: Plain text
#: kraft.adoc:928
msgid ""
"On the linux desktop, apps are usually started through a so called "
"https://specifications.freedesktop.org/desktop-entry-spec/latest/[desktop "
"file]. It contains the information how the Kraft binary is started if user "
"clicks on the icon on the desktop or in the start menu."
msgstr ""

#. type: Plain text
#: kraft.adoc:930
msgid ""
"The desktop file can usually be found in "
"`/usr/share/applications/de.volle-kraft-voraus.kraft.desktop`."
msgstr ""

#. type: Plain text
#: kraft.adoc:936
msgid ""
"It contains the line ``` Exec=kraft %u ``` which starts the application with "
"the default locale."
msgstr ""

#. type: Plain text
#: kraft.adoc:942
msgid ""
"Changing it to ``` Exec=env LANG=de_DE.UTF-8 kraft %u ``` would change that "
"to run in the German locale for example, independent from the desktop "
"environment location."
msgstr ""

#. type: Title ==
#: kraft.adoc:945
#, no-wrap
msgid "Credits and License"
msgstr ""

#. type: Plain text
#: kraft.adoc:948
msgid "Program and documentation copyright 2004â2023 Klaas Freitag"
msgstr ""

#. type: Plain text
#: kraft.adoc:949
msgid "Documentation copyright 2020-2023 Ronald Stroethoff"
msgstr ""
