.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ====================== EXT: YAG Library Theme ====================== :Created: 2010-02-18T17:33:18 :Changed: 2013-01-25T18:35:48 :Classification: yag_theme_library :Keywords: yag Yet Another Gallery :Author: Daniel Lienert :Email: daniel@lienert.cc :Info 4: :Language: en |img-1| |img-2| EXT: YAG Library Theme - yag\_theme\_library .. _EXT-YAG-Library-Theme: EXT: YAG Library Theme ====================== Extension Key: yag\_theme\_library Language: en Keywords: yag Yet Another Gallery Copyright 2000-2010, Daniel Lienert, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.org .. _Table-of-Contents: Table of Contents ----------------- `EXT: Readable name of your extension 1 <#1.EXT:%20Readable%20name%20of%20your%20extension|outline>`_ **`Introduction 3 <#1.1.Introduction|outline>`_** `What does it do? 3 <#1.1.1.What%20does%20it%20do_|outline>`_ `Screenshots 3 <#1.1.2.Screenshots|outline>`_ **`Users manual 4 <#1.2.Users%20manual|outline>`_** `FAQ 4 <#1.2.1.FAQ|outline>`_ **`Administration 5 <#1.3.Administration|outline>`_** `FAQ 5 <#1.3.1.FAQ|outline>`_ **`Configuration 6 <#1.4.Configuration|outline>`_** `FAQ 6 <#1.4.1.FAQ|outline>`_ `Reference 6 <#1.4.2.Reference|outline>`_ **`Tutorial 7 <#1.5.Tutorial|outline>`_** **`Known problems 8 <#1.6.Known%20problems|outline>`_** **`To-Do list 9 <#1.7.To-Do%20list|outline>`_** **`ChangeLog 10 <#1.8.ChangeLog|outline>`_** `Important guidelines 11 <#2.Important%20guidelines|outline>`_ **`Issues with Open Office documentation for TYPO3 12 <#2.1.Issues%20w ith%20Open%20Office%20documentation%20for%20TYPO3|outline>`_** `Inserting images 12 <#2.1.1.Inserting%20images|outline>`_ `Paragraph styles 12 <#2.1.2.Paragraph%20styles|outline>`_ `Linking 13 <#2.1.3.Linking|outline>`_ `Meta data and updates 13 <#2.1.4.Meta%20data%20and%20updates|outline>`_ `HowTo: Update a manual to the new layout 13 <#2.1.5.HowTo:%20Update%2 0a%20manual%20to%20the%20new%20layout|outline>`_ `HowTo: (alternative) Import the styles from another document 14 <#2.1 .7.HowTo:%20(alternative)%20Import%20the%20styles%20from%20another%20d ocument|outline>`_ `HowTo: Fix the Table Of Contents when it is empty 14 <#2.1.8.HowTo:%2 0Fix%20the%20Table%20Of%20Contents%20when%20it%20is%20empty%20|outline >`_ `HowTo: Fix the Table Of Contents when a chapter is missing 14 <#2.1.9 .HowTo:%20Fix%20the%20Table%20Of%20Contents%20when%20a%20chapter%20is% 20missing%20|outline>`_ `Help by documentation.openoffice.org 14 <#2.1.10.Help%20by%20documentation.openoffice.org|outline>`_ .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ The Library theme makes have use of the pt\_extlist extension which powers the item-listings of YAG, to implement a filterable image library. .. _Users-manual: Users manual ------------ I think it is self explaining. .. _Administration: Administration -------------- Install the extension and include its static template. .. _Configuration: Configuration ------------- Pt\_extlist is a powerful tool to list any kinds of database items with only typoscript configuration. To learn about the configuration options, read the pt\_extlist manual and its typoscript refernce. .. _To-Do-list: To-Do list ---------- - A wish list of things you want to add or fix. This includes smaller problems/bugs which are best described as a todo item. - Visions for what the extension could become with more development. - `TYPO3 Forge link to your project `_ .. _ChangeLog: ChangeLog --------- - Create a file "ChangeLog" (see e.g. the extension "cal" as example) to inform about changes or - Use this section to document all the changes through the versions. - Alternative to the following list: `ChangeLog online (point this link to YOUR extension) `_ .. ### BEGIN~OF~TABLE ### .. _0-1-0: 0.1.0 ^^^^^ .. container:: table-row Version 0.1.0 Changes Added / Changed/ Caught error .. ###### END~OF~TABLE ###### .. _Important-guidelines: Important guidelines ==================== .. _Issues-with-Open-Office-documentation-for-TYPO3: Issues with Open Office documentation for TYPO3 ----------------------------------------------- There are a few important points to make about writing documentation for TYPO3 in Open Office. Please makes sure to follow these. .. _Inserting-images: Inserting images ^^^^^^^^^^^^^^^^ When you insert images you can either: - |img-3| Make a copy/paste from eg. Photoshop, but it's **REALLY IMPORTANT** that you insert the image into Open Office by the menu “Edit > Paste Special” and then select “Bitmap”. If you don't do it in this way the image cannot be shown (since it will not be stored as a PNG internally in the SXW file) - Alternatively you can use the traditional way “ **Insert > Graphics > From file** ” and insert an image from your harddrive. In particular use this if the image is photographic (JPG) since the internal storage as PNG is not good for photographs. Generally please use copy/paste only for screendumps with large areas of similar color (good png-compression) and JPG-files for photographic images. Go for small images, 72 dpi, medium quality. .. _Paragraph-styles: Paragraph styles ^^^^^^^^^^^^^^^^ - Use the paragraph style “Text body” for bodytext - Use “Heading 1” to “Heading 5” for headers. “Heading 1-3” will be recognized as “sections” on typo3.org. “Heading 4-5” is subheaders, where “Heading 5” is preferrably for “Examples”. - For code listings, use the style “Preformatted Text” (found under “HTML Styles”). For codelistings in tables there is a custom style called “Table Contents/PRE”. This screenshot shows the only paragraph styles allowed in the documents. The ones grayed out are paragraph styles that are used by default for such as the index table or the footer. The others are the ones you are allowed to use. |img-4| .. _Linking: Linking ^^^^^^^ You can make hyperlinks in the documents as absolute URLs. Use menu “Insert > Hyperlink” .. _Meta-data-and-updates: Meta data and updates ^^^^^^^^^^^^^^^^^^^^^ There are three fields of meta-data you have to fill in. First of all go to “File > Properties...”. |img-5| - In the “Description” screen you enter the title of the document. Extension manuals are prefixed “EXT: [extension title]” - In the “User defined” screen you enter your email address as the first field (named “Email” / ”Info 1”) - In the “User defined” screen you enter your full name as the second field (named “Author” / ”Info 2”) Finally you should also insert the correct extension key in the text below the document title, but this is not a meta-data field, just regular text. .. _HowTo-Update-a-manual-to-the-new-layout: HowTo: Update a manual to the new layout ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ With these steps you get it very fast - Update the extension doc\_template (maybe a new one is out) - Hit the F11 key to show the styles - >> Copy everything from your old manual except the title page and the table of contents << - Delete contents from new manual but leave the title page and the table of contents there - Paste your content and check that formatting is correct and images are in place - Hint: When the header-styles are still in the old layout then **clear** and **re-assign** the new style - Update the page properties with your extension key, e-mail-address, name, language, tagging.In the moment the language- and tagging- properties are not in use by the TER, but findable by search. - Reload the table of content (right click update index table) - Insert your extension key below the document title Ready. .. _HowTo-alternative-Import-the-styles-from-another-document: HowTo: (alternative) Import the styles from another document ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - |img-6| (!) In some old OpenOffice versions (e.g. 2.4) there's a bug: after the import you need the HowTo “Fix the TOC” - Load your manual, then hit the F11 key to show the styles - Klick on the small arrow top-right - A select box appears , you klick at “Load Styles” and then “From File” - (!) Check all the boxes - Navigate to the “doc\_template”/doc” folder and switch the file-type to .sxw “OpenOffice.org 1.0 Textdocument” - Open the manual.sxw, now you can use the new style! .. _HowTo-Fix-the-Table-Of-Contents-when-it-is-empty: HowTo: Fix the Table Of Contents when it is empty ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Maybe the outline numbering is broken (german: “Kapitelnummerierung”). - Go to menu "Tools” > “Outline Numbering" and apply the missing "Heading" styles to the empty levels. - Update the TOC, ready. .. _HowTo-Fix-the-Table-Of-Contents-when-a-chapter-is-missing: HowTo: Fix the Table Of Contents when a chapter is missing ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ You have changed the styling of a header. Clear the formatting of the header and re-assign the header-style .. _Help-by-documentation-openoffice-org: Help by documentation.openoffice.org ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ See the international portal for help: `http://documentation.openoffice.org `_ |img-2| 13 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :border: 0 .. :height: 21 .. :hspace: 9 .. :id: Grafik2 .. :name: Grafik2 .. :width: 87 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 129 .. :id: Graphic3 .. :name: Graphic3 .. :width: 224 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 363 .. :id: Graphic2 .. :name: Graphic2 .. :width: 241 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 222 .. :id: graphics2 .. :name: graphics2 .. :width: 325 .. |img-6| image:: img-6.png .. :align: left .. :border: 0 .. :height: 213 .. :id: graphics3 .. :name: graphics3 .. :width: 265