wiki:syntaxe_des_extensions
Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente | ||
wiki:syntaxe_des_extensions [01.04.2018 @ 17:30] – MetallicaMust | wiki:syntaxe_des_extensions [14.02.2021 @ 14:02] (Version actuelle) – old revision restored MetallicaMust | ||
---|---|---|---|
Ligne 2: | Ligne 2: | ||
<WRAP center round todo 60%> | <WRAP center round todo 60%> | ||
- | Page en développement. ATTENTION, Tous les liens n'ont pas été mis-à-jour ! Ce sont encore des données bruts. Une boîte " | + | Page en développement. ATTENTION, Tous les liens n'ont pas été mis-à-jour ! |
- | --- // | + | --- // |
</ | </ | ||
Ligne 11: | Ligne 11: | ||
===== Info Plugin ===== | ===== Info Plugin ===== | ||
- | |||
- | <WRAP center round info 60%> | ||
- | Liens OK, reste à traduire. | ||
- | </ | ||
< | < | ||
Ligne 30: | Ligne 26: | ||
| | ||
===== Random Include Plugin ===== | ===== Random Include Plugin ===== | ||
- | |||
- | <WRAP center round info 60%> | ||
- | Liens OK, reste à traduire. | ||
- | </ | ||
Enclose the namespace from where to select the page in double curly brackets. Refer to [[#Include plugin]] for detailed information here are only described the added functionallities. | Enclose the namespace from where to select the page in double curly brackets. Refer to [[#Include plugin]] for detailed information here are only described the added functionallities. | ||
Ligne 48: | Ligne 40: | ||
===== htmlmetatags plugin ===== | ===== htmlmetatags plugin ===== | ||
- | |||
- | <WRAP center round info 60%> | ||
- | Liens OK, reste à traduire. | ||
- | </ | ||
- | |||
- | With the string '' | ||
- | |||
- | Also, the plugin is on page level. | ||
- | |||
- | Example to activate the plugin on your page write: | ||
- | |||
- | < | ||
- | {{htmlmetatags> | ||
- | </ | ||
- | |||
- | The meta tag: //mytag// is any word. This word is the name of the new meta tag, e.g. keyword. Followed on this name is to write '' | ||
- | |||
- | You can write more than once meta tag on the page separate by space. | ||
- | |||
- | < | ||
- | {{htmlmetatags> | ||
- | metatag-keywords=(apfel, | ||
- | metatag-description=(Allgemeiner Obstbauer) | ||
- | metatag-media-og: | ||
- | metatag-og: | ||
- | metatag-og: | ||
- | }} | ||
- | |||
- | </ | ||
- | |||
- | The **result** on web page is: | ||
- | |||
- | <code html> | ||
- | <meta name=" | ||
- | <meta name=" | ||
- | <meta name=" | ||
- | <meta property=" | ||
- | <meta property=" | ||
- | <meta property=" | ||
- | </ | ||
- | |||
===== Snippets Plugin ===== | ===== Snippets Plugin ===== | ||
- | |||
- | ==== Usage ==== | ||
- | |||
- | <WRAP center round info 60%> | ||
- | Liens et images, reste à traduire. | ||
- | </ | ||
- | |||
- | Create your snippets and then add them as an unordered list of links to the '' | ||
- | < | ||
- | * [[snippet_1|]] | ||
- | * [[snippet_2|General Instructions]] | ||
- | * [[snippet_3|Valid Users]] | ||
- | </ | ||
- | However, if your snippet is derived from a namespace template, then you must use a special form of link which is described below in the section on using [[# | ||
- | |||
- | Clicking on the snippets' | ||
- | |||
- | {{ : | ||
- | |||
- | In the left-hand pane of the pop-up is the list of links derived from the '' | ||
- | |||
- | If you don't want this insertion to be updatable, uncheck the " | ||
- | |||
- | When the '' | ||
- | |||
- | The header markup looks like this: '' | ||
- | |||
- | ==== How the updates are processed ==== | ||
- | |||
- | The plugin keeps a database that records the associations between snippets and the pages where they are embedded; in addition the meta file for each page containing snippets keeps a record of each snippet and its timestamp. | ||
- | |||
- | There are two ways that snippets are updated: | ||
- | - When a page with a revised snippet is opened for revision, the revised snippet will automatically replace the old version in the editing window. For the change to become permanent, the page must be saved. | ||
- | - When a snippet is revised, a table will appear at the bottom of its page with a listing of the pages that have used the snippet. \\ {{: | ||
- | |||
- | For more details about the snippets plugin internals, see [[doku> | ||
- | |||
- | === Admin: Metadata Clean-Up Tool === | ||
- | |||
- | On the Administration Page, there is a tool which enables you to reconcile any differences between the information in the database and the content on the wiki pages. You will find it listed under " | ||
- | |||
- | ==== Inserting Comments into Snippets ==== | ||
- | |||
- | You can use the following syntax inside your snippets to provide additional comments which will get stripped out when you insert the snippet into the page you are editing. | ||
- | |||
- | < | ||
- | < | ||
- | Additional comments, i.e. you have to provide the following information: | ||
- | |||
- | * foo | ||
- | * bar | ||
- | </ | ||
- | </ | ||
- | |||
- | ==== Namespace Templates as Snippets ==== | ||
- | |||
- | === Creating Links to Namespace Templates === | ||
- | |||
- | Namespace templates can be used as snippets. There are two ways to do this: | ||
- | - A standard namespace template is in included in a directory. | ||
- | - Alternatively, | ||
- | |||
- | In both cases the dummy file is used as the link in the snippets listing and when the link is clicked, the snippet is inserted into your page. There is one circumstance in which the contents of a dummy page is not ignored. | ||
- | |||
- | The following is a schematic for entering these snippets into the links on the [[doku> | ||
- | < | ||
- | [[templ_admin|admin data]] | ||
- | [[templ: | ||
- | [[distro_templ: | ||
- | [[: | ||
- | </ | ||
- | For '' | ||
- | < | ||
- | admin data | ||
- | policies | ||
- | distro data | ||
- | personal data | ||
- | </ | ||
- | |||
- | - '' | ||
- | - '' | ||
- | - '' | ||
- | - '' | ||
- | |||
- | The dummy pages themselves are not changed. They are just placeholders. | ||
- | |||
- | These snippets are not updatable. The '' | ||
- | |||
- | === Replacement Patterns === | ||
- | Any replacement patterns that refer to page names, files and Dokuwiki ID's must have their '' | ||
- | |||
- | |@ID@|#ID#| | ||
- | |@NS@|#NS#| | ||
- | |@FILE@|# | ||
- | |@!FILE@|# | ||
- | |@!FILE!@|# | ||
- | |@PAGE@|# | ||
- | |@!PAGE@|# | ||
- | |@!!PAGE@|# | ||
- | |@!PAGE!@|# | ||
- | |||
- | The other replacement patterns remain the same, '' | ||
- | |||
===== Bookcreator Plugin ===== | ===== Bookcreator Plugin ===== | ||
- | |||
- | <WRAP center round info 60%> | ||
- | Liens et images OK, reste à traduire. | ||
- | </ | ||
- | |||
- | ==== Usage ==== | ||
- | |||
- | === Create book manage tools on wiki:ebook === | ||
- | |||
- | Before using this plugin, you need to create a page with the bookmanager. Therefore you place the syntax '' | ||
- | | ||
- | In the bookmanager can show and manage your list of selected pages | ||
- | * Reset current selection | ||
- | * Exclude/ | ||
- | * View the excluded pages and " | ||
- | * Drag and drop to change exporting order of page and remove/add page to the selection. | ||
- | * Set a title for the PDF document | ||
- | * Create the PDF book on selected pages | ||
- | * Create a printable version of selected pages | ||
- | * Extract only text of selected pages | ||
- | * Save and restore selections on a specific namespace (use ACL's rights) | ||
- | |||
- | == Example == | ||
- | |||
- | Put at the '' | ||
- | < | ||
- | ~~BOOK~~ | ||
- | </ | ||
- | And __after__ you mark at least one page for inclusion in the book, the bookmanager appears. | ||
- | {{ : | ||
- | |||
- | === Initiate a book === | ||
- | |||
- | {{ : | ||
- | Use the // | ||
- | |||
- | After selecting the first page, a toolbar appears on every page that let you add or remove additional pages. This toolbar refers also to the book manage tool. | ||
- | |||
- | {{: | ||
- | |||
- | The book manage tool that you created above (default on '' | ||
- | |||
- | === Show saved selections === | ||
- | |||
- | Below the bookmanager is a listed displayed with saved selections. You can also display with ''< | ||
- | * Available action: Load a saved selection into the bookmanager again | ||
- | * Optionally you can specify the number of selections to display and the order: | ||
- | * '' | ||
- | * '' | ||
- | * a //number// limits the number of displayed selections | ||
- | |||
- | Default is 10 items ordered by date (last updated are sorted first). Each entry links also to the wiki page where their selection is saved. Per page only one list of saved selections is displayed. | ||
- | |||
- | The user can only see selections when he has at least read access for the namespace '' | ||
- | |||
- | == Example == | ||
- | Lists 5 selections, sorted by date | ||
- | < | ||
- | ~~ARCHIVEBOOK: | ||
- | </ | ||
- | {{: | ||
- | |||
===== talkpage plugin ===== | ===== talkpage plugin ===== | ||
- | |||
- | <WRAP center round info 60%> | ||
- | Reste à traduire. | ||
- | </ | ||
- | |||
- | Simply add the macro '' | ||
- | |||
===== Meta plugin ===== | ===== Meta plugin ===== | ||
- | |||
- | <WRAP center round info 60%> | ||
- | Liens OK. Reste à traduire. | ||
- | </ | ||
- | |||
- | ==== Syntax ==== | ||
- | |||
- | ~~META: | ||
- | key = value | ||
- | ~~ | ||
- | |||
- | ^ key | the metadata element to set | required | | ||
- | ^ value | the metadata element content | required | | ||
- | |||
- | You can set more than one element at once by using an ''&'' | ||
- | |||
- | === An example === | ||
- | |||
- | ~~META: | ||
- | creator | ||
- | &date valid = 2006-04-15 -> 2006-10-15 | ||
- | ~~ | ||
- | |||
- | ==== Data Structure ==== | ||
- | |||
- | It is mandatory to use [[http:// | ||
- | |||
- | ^ Element ^ Child Elements ^ Type ^ Comments ^ | ||
- | | title | --- | string | will be used for window title and links if '' | ||
- | | creator | --- | string | indicates the primary author of a page; defaults to the full name of the user who created the page | | ||
- | | subject | --- | string | used by the [[doku> | ||
- | | description | tableofcontents, | ||
- | | publisher | --- | string | not used | | ||
- | | contributor | --- | array | a list of all users who have made non-minor contributions to the page; every item has the user ID as key and the full name as value | | ||
- | | date | created, valid, available, issued, modified | array | a timestamp (or an array of the timestamps '' | ||
- | | type | --- | string | not set, but defaults to " | ||
- | | format | --- | string | a MIME type is expected; not set, but defaults to " | ||
- | | identifier | --- | string | a unique ID of the page; not set, but defaults to the page ID when exported | | ||
- | | source | --- | string | not used | | ||
- | | language | --- | string | a two-letter language code is expected; not set, but defaults to the chosen language for DokuWiki when exported | | ||
- | | relation | isversionof, | ||
- | | coverage | spatial, temporal | array | not used | | ||
- | | rights | accessrights, | ||
- | |||
===== Box Plugin ===== | ===== Box Plugin ===== | ||
- | |||
- | <WRAP center round info 60%> | ||
- | Liens OK. Reste à traduire. | ||
- | </ | ||
- | |||
- | A simple box: | ||
- | |||
- | <box> the box contents </ | ||
- | |||
- | Some more complex boxes | ||
- | |||
- | <box 80% round orange|a title> the box contents</ | ||
- | <box 50% left blue>the box contents</ | ||
- | <box 60% round #f99 #fc9 #fcc # | ||
- | |||
- | The full syntax: | ||
- | |||
- | '' | ||
- | |||
- | * //width// --- any legal CSS width value | ||
- | * //classes// --- any number of classes which use the styles in your template or the plugin' | ||
- | * //round// --- box will have rounded corners | ||
- | * //blue// --- blue colour scheme | ||
- | * //red// --- red colour scheme | ||
- | * //green// --- green colour scheme | ||
- | * //orange// --- orange colour scheme | ||
- | * //left// --- float the box left within the wiki page | ||
- | * //right// --- float the box right within the wiki page | ||
- | if no classes are specified the default styles will be used, that is square corners in a colour scheme based on the default DokuWiki colour scheme. | ||
- | |||
- | * //colours// --- 1-4 colours in CSS hex or RGB notation, e.g. ''# | ||
- | - content background | ||
- | - title background | ||
- | - outer box background | ||
- | - borders | ||
- | if less than four colours are specified, the first colour is used for the missing colours. | ||
- | |||
- | * //title text// --- text (including DokuWiki markup) displayed above the box contents, with distinct style. | ||
- | * //caption text// --- text (no markup allowed) displayed below the box contents, with distinct style. | ||
- | |||
- | The opening '' | ||
- | |||
- | |||
- | See the plugin in action [[http:// | ||
- | |||
===== Tag Plugin ===== | ===== Tag Plugin ===== | ||
- | |||
- | <WRAP center round info 60%> | ||
- | Pas fait. | ||
- | </ | ||
- | |||
- | ==== Components ==== | ||
- | |||
- | === Tag === | ||
- | |||
- | {{tag> | ||
- | |||
- | ^ [list of tags] | a space separated list of tags that describe the content of the current page | required | ||
- | |||
- | Allows you to categorize your wiki pages. The resulting links either point to the corresponding page in the specified tag namespace (only if it exists). If you want a link to point to a page in another namespace, you have to indicate the namespace before the tag name. If this page doesn' | ||
- | |||
- | Examples: | ||
- | * '' | ||
- | * with namespaces: '' | ||
- | * multiple word tags: '' | ||
- | |||
- | |||
- | === Topic === | ||
- | |||
- | {{topic> | ||
- | |||
- | ^ [tag] | the category tag for which you want a list of pages | required | ||
- | ^ [flags] | ||
- | |||
- | This displays a list of all pages that contain the given category tag. The list is sorted alphabetically by page ID. You can also prepend the modifiers '' | ||
- | |||
- | Example: | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | |||
- | === Searchtags === | ||
- | |||
- | | ||
- | |||
- | ^ [flags] | pagelist flags delimited by ''&'', | ||
- | |||
- | This displays a search form with the possibility to select a namespace and to select tags from a table of all tags that should either be in- or excluded with the option to choose if the tags should be associated with AND or OR. The results are displayed as in the topic component. | ||
- | |||
- | This is a great feature which you should not miss. Please add a screenshot of this cool feature. FIXME | ||
- | |||
- | And you might check out [[plugin: | ||
- | |||
- | Example: | ||
- | * '' | ||
- | * '' | ||
- | === Count === | ||
- | |||
- | {{count> | ||
- | |||
- | ^ [tag] | the category tag for which you want to list the occurrence | ||
- | |||
- | This part allows you to display an overview of your current used tags. It prints the tag and the related occurrence (how often is the tag used?) in your wiki. Either you can specify a '' | ||
- | |||
- | Example: | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | | ||
- | === Tagpage === | ||
- | |||
- | | ||
- | |||
- | This displays a link to the listing of all tags as it is done by the [[#Tag]] syntax but without tagging the page with that tag. With the optional '' | ||
- | |||
- | Example: | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | |||
- | ==== Configuration ==== | ||
- | |||
- | The plugin can be configured with the DokuWiki configuration manager available in the admin menu. | ||
- | |||
- | ^ '' | ||
- | ^ '' | ||
- | ^ '' | ||
- | ^ '' | ||
- | ^ '' | ||
- | ^ '' | ||
- | ^ '' | ||
- | |||
- | ==== Tagindex Rebuild ==== | ||
- | |||
- | If the tag index becomes corrupted somehow (such as by using page move), then you can rebuild it by using the [[searchindex]] plugin or [[: | ||
- | |||
- | ==== Demo / Screenshots ==== | ||
- | |||
- | {{ http:// | ||
- | |||
- | {{ http:// | ||
- | |||
===== Translation Plugin ===== | ===== Translation Plugin ===== | ||
- | |||
- | ==== Usage ==== | ||
- | |||
- | The plugin does its work automatically by being called from the template (see [[# | ||
- | |||
- | < | ||
- | ~~NOTRANS~~ | ||
- | </ | ||
- | |||
- | ==== Namespace template variables ==== | ||
- | |||
- | The translation plugin adds variables usable in [[: | ||
- | ^ Variable ^ Description ^ Example ^ | ||
- | | @LANG@ | Language you have entered in your [[config: | ||
- | | @TRANS@ | The currently used language. This variable will be empty, if your default language has no sub namespace. | en:start -> en, start -> < | ||
- | |||
===== Include plugin ===== | ===== Include plugin ===== | ||
Ligne 582: | Ligne 156: | ||
===== Dw2Pdf plugin ===== | ===== Dw2Pdf plugin ===== | ||
- | |||
- | ==== Usage ==== | ||
- | There are three ways to export: | ||
- | * **Export one page**\\ You simply need to call the page with an additional '' | ||
- | * **Export an entire namespace**\\ There is the URL parameter '' | ||
- | * **Export selection of pages**\\ If you need to select just some pages to export to one PDF, you can use [[plugin: | ||
- | |||
- | ==== Syntax ==== | ||
- | |||
- | To create a link in any wiki page to export any namespace, you can use the following syntax: | ||
- | '' | ||
- | * '' | ||
- | * '' | ||
- | * You can add further options (like '' | ||
- | |||
- | Handling of [[config: | ||
- | |||
===== Open Document Plugin ===== | ===== Open Document Plugin ===== | ||
- | |||
- | ==== Usage ==== | ||
- | |||
- | To make a single page exportable you can add the following macro to the page: | ||
- | |||
- | ~~ODT~~ | ||
- | |||
- | A better way is to integrate an export button into your [[: | ||
- | |||
- | If you use the default template just switch the button on in the configuration menu. | ||
- | |||
- | Otherwise use the following to add another button in the upper or bottom button row of the template((In ''/ | ||
- | |||
- | <code html> | ||
- | <form class=" | ||
- | <div class=" | ||
- | <input type=" | ||
- | <input type=" | ||
- | <input type=" | ||
- | </ | ||
- | </ | ||
- | </ | ||
- | |||
- | Or use this for a simple 16x16 icon somewhere in your template: | ||
- | |||
- | <code html> | ||
- | <a href="<? | ||
- | </ | ||
- | |||
- | You can mix the 2 previous methods, and get a button with an image inside, with this code: | ||
- | <code html> | ||
- | <form class=" | ||
- | <div class=" | ||
- | <button type=" | ||
- | <img src="<? | ||
- | | ||
- | </ | ||
- | <input type=" | ||
- | <input type=" | ||
- | <input type=" | ||
- | </ | ||
- | </ | ||
- | </ | ||
- | |||
- | ==== Additional syntax tags ==== | ||
- | |||
- | There are some syntax tags for additional features which can not be set in the configuration alone because e.g. the position matters or to provide more flexibility. These tags are described in this section. | ||
- | |||
- | === pagebreak === | ||
- | |||
- | A manual pagebreak can be inserted by adding the syntax tag ''< | ||
- | |||
- | === page === | ||
- | |||
- | The syntax tag '' | ||
- | |||
- | < | ||
- | |||
- | The following example sets the page format **A3**, orientation **landscape** and all margins to **1** centimeter. | ||
- | < | ||
- | |||
- | You can also omit parameters that you do not want to change, e.g.: | ||
- | < | ||
- | That changes the page format and orientation but not the margins. | ||
- | |||
- | If you want to alter a single page property only, then you can use the settings tags for format, orientation or the margins alone. See some examples below: | ||
- | |||
- | < | ||
- | {{odt> | ||
- | {{odt> | ||
- | |||
- | {{odt> | ||
- | {{odt> | ||
- | |||
- | {{odt> | ||
- | {{odt> | ||
- | {{odt> | ||
- | {{odt> | ||
- | </ | ||
- | |||
- | A change of the page format will finish the current page, cause a pagebreak and the next page will then use the newly set page format. | ||
- | |||
- | === toc === | ||
- | |||
- | The toc syntax tag can be used to insert a table of contents at the position of the tag. Without inserting the toc syntax tag, no table of contents will be created at all. The minimum syntax is: | ||
- | |||
- | < | ||
- | |||
- | This will create a table of contents with all relevant settings taken from the ODT plugin configuration. The title will be 'Table of Contents' | ||
- | |||
- | The following options for the toc syntax tag do exist: | ||
- | |||
- | * **maxlevel: | ||
- | * **title:** this overwrites the language specific default title 'Table Of Contents' | ||
- | * **leader_sign: | ||
- | * **indents: | ||
- | * **pagebreak: | ||
- | * **styleH:** this overwrites the **Contents Heading** style in the styles.xml file | ||
- | * **styleL1 ... styleLN:** N = maxlevel, overwrites toc_style | ||
- | |||
- | These have all the same meaning as the corresponding configuration settings. Only exception is **styleL1 ... styleLN**. The configuration setting toc_style sets the style for the whole table of contents. **styleL1** only sets the style for toc level 1, **styleL2** only sets the style for toc level 2... | ||
- | |||
- | The option **syntaxH** works the same way as the **styleL** option above but sets the style for the table of contents heading. | ||
- | |||
- | All these options are optional. If you omit one, then the corresponding setting of the configuration (or URL request parameter) will be used. Every option needs to be finished with a **;** . | ||
- | |||
- | Here are some examples (all one line): | ||
- | |||
- | < | ||
- | {{odt> | ||
- | styleL1=" | ||
- | styleL3=" | ||
- | </ | ||
- | |||
- | < | ||
- | {{odt> | ||
- | styleL1=" | ||
- | styleL3=" | ||
- | </ | ||
- | |||
- | === chapter-index === | ||
- | |||
- | The chapter-index syntax tag can be used to insert a chapter-index at the position of the tag. Without inserting the chapter-index syntax tag, no chapter indexes will be created at all. The minimum syntax is: | ||
- | |||
- | < | ||
- | |||
- | This will create a chapter-index with all relevant settings taken from the ODT plugin configuration for the table of contents. By default the chapter-index will have no title. | ||
- | |||
- | The options for the chapter-index syntax tag are the same as for the toc syntax tag. | ||
- | |||
- | === disablelinks/ | ||
- | |||
- | These tags enable or disable link creation just like the configuration setting. Here is the syntax: | ||
- | |||
- | < | ||
- | {{odt> | ||
- | {{odt> | ||
- | </ | ||
- | |||
- | === templatepage === | ||
- | |||
- | This tag can be used to specify a wiki page as a CSS template. That means all content from the page is imported as CSS code. Example: | ||
- | |||
- | This feature enables the user to use a CSS template without the need of uploading any files. ATTENTION: using a template page may overwrite already imported style settings from an ODT or CSS template file. | ||
- | |||
- | === frame-open/ | ||
- | |||
- | These tags insert the content between them inside an ODT frame on export to ODT. The HTML view is not changed. Here is the syntax: | ||
- | |||
- | < | ||
- | {{odt> | ||
- | {{odt> | ||
- | </ | ||
- | |||
- | Putting content in a frame can e.g be used to position that content on a fixed point of the page. This e.g. can be useful for writing letters. | ||
- | |||
- | See [[plugin: | ||
- | |||
- | FIXME: create page, describe frame usage in detail FIXME | ||
- | |||
===== Gallery Plugin ===== | ===== Gallery Plugin ===== | ||
- | |||
- | ==== Syntax ==== | ||
- | |||
- | A basic gallery can be added by selecting a [[: | ||
- | |||
- | {{gallery>: | ||
- | |||
- | All image files in the selected namespace will be added to the image gallery. Don't forget the ":" | ||
- | |||
- | Instead of using a whole namespace of images, you can also specify a single image -- this makes more sense when combined with the lightbox mode (see below). | ||
- | |||
- | {{gallery>: | ||
- | |||
- | The created gallery can be aligned by using white space (defaults to centered): | ||
- | |||
- | {{gallery> | ||
- | {{gallery> | ||
- | {{gallery> | ||
- | |||
- | Instead of a namespace, you can also give an HTTP(s) URL to any [[wp> | ||
- | |||
- | {{gallery> | ||
- | |||
- | Note: since the question mark is used to separate the parameters (see next section) the URL can not contain any question mark. To use such a feed URL with the gallery plugin, just use one of the many short URL services like [[http:// | ||
- | |||
- | E.g. instead of '' | ||
- | |||
- | Additionally, | ||
- | |||
- | === Parameters === | ||
- | |||
- | A number of parameters can be set by appending them with ''?'' | ||
- | |||
- | ^ Parameter | ||
- | | ''//< | ||
- | | ''//< | ||
- | | ''//< | ||
- | | '' | ||
- | | '' | ||
- | | '' | ||
- | | '' | ||
- | | '' | ||
- | | '' | ||
- | | '' | ||
- | | '' | ||
- | | '' | ||
- | | '' | ||
- | | '' | ||
- | | '' | ||
- | | '' | ||
- | | '' | ||
- | | '' | ||
- | | anything containing a '' | ||
- | |||
- | == Example == | ||
- | |||
- | {{gallery> | ||
- | |||
- | This displays all images beginning with '' | ||
- | |||
- | == Example == | ||
- | |||
- | {{gallery>? | ||
- | |||
- | This displays all images in the current namespace using 2 parameters. Parameterlist begins with ''?'' | ||
- | |||
===== Wrap Plugin ===== | ===== Wrap Plugin ===== | ||
- | <WRAP center round info 60%> | ||
- | Image OK, reste à traduire. | ||
- | </ | ||
- | |||
- | ==== Syntax ==== | ||
- | |||
- | Basic Syntax: | ||
- | <WRAP classes #id width : | ||
- | " | ||
- | </ | ||
- | | ||
- | **or** | ||
- | <block classes #id width : | ||
- | " | ||
- | </ | ||
- | | ||
- | or | ||
- | <div classes #id width : | ||
- | " | ||
- | </ | ||
- | An uppercase **%%< | ||
- | | ||
- | <wrap classes #id width : | ||
- | | ||
- | or | ||
- | <inline classes #id width : | ||
- | | ||
- | or | ||
- | <span classes #id width : | ||
- | A lowercase **%%< | ||
- | |||
- | Since version 2013-06-13 there is also a shorthand syntax (for wraps without content): | ||
- | |||
- | <WRAP classes #id /> or <block classes #id /> or <div classes #id /> | ||
- | |||
- | and | ||
- | |||
- | <wrap classes #id /> or <inline classes #id /> or <span classes #id /> | ||
- | |||
- | :!: Please note, some things **won' | ||
- | |||
- | === Examples === | ||
- | |||
- | The plugin comes with an example page, which should explain a lot and looks like this in the default template (see below). | ||
- | |||
- | === Classes === | ||
- | |||
- | The following classes are currently available: | ||
- | |||
- | {{ : | ||
- | |||
- | ^ class name ^ description/ | ||
- | ^ __columns__ -- similar to [[columns]], | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | ^ __widths__ -- :!: **experimental**, | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | ^ __alignments__ -- similar to [[divalign]], | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | ^ __boxes and notes__ -- similar to [[box]], [[note]], [[tip]] | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | ^ __marks__ -- similar to [[emphasis]], | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | ^ __miscellaneous__ | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | | **'' | ||
- | |||
- | All tables inside a column or box will always be 100% wide. This makes positioning and sizing tables possible and partly replaces [[tablewidth]]. | ||
- | |||
- | == Known restrictions == | ||
- | |||
- | * WRAPs won't export in ODT format. | ||
- | * Round corners only work in modern browsers (no IE8 and below). | ||
- | * Multiple columns only work in modern browsers (no IE9 and below). | ||
- | * Width classes are experimental and only work in modern browsers (no IE8 and below). | ||
- | * Normal DokuWiki Headlines used to not work and a work-around was added. Now that headlines do work, the work-around is not needed anymore but kept for backwards-compatibility. The following syntax would produce two different kinds of emulated headlines inside any of the columns or boxes/ | ||
- | * %%//**__Big Underlined Headline__**// | ||
- | * %%//**Small Headline**// | ||
- | |||
- | You might need to adjust a few of the classes to your template' | ||
- | |||
- | The classes are easily adjustable and extensible. Any wishes are welcome. | ||
- | |||
- | === Widths === | ||
- | |||
- | You can set any valid widths on any uppercase %%< | ||
- | <WRAP someclass 50% anotherclass> | ||
- | All except percentages will be reduced to have the maximum width available on smaller screens. | ||
- | |||
- | You can also use the width keywords '' | ||
- | <WRAP group> | ||
- | <WRAP half column> | ||
- | <WRAP half column> | ||
- | </ | ||
- | will result in two columns next to each other, which will wrap underneath each other on smaller screens and mobile devices. | ||
- | |||
- | === Languages and Text Directions === | ||
- | |||
- | You can change the language and the direction of a container by simply adding a colon followed by the language code, like this: | ||
- | |||
- | <wrap :en>This text is explicitly marked as English.</ | ||
- | |||
- | The text direction ('' | ||
- | |||
- | If you like to mark a text with a different text direction than the default one, you should use divs, i.e. uppercase '' | ||
- | |||
- | This makes it a better replacement of [[ltr]] (and [[lang]]). |
wiki/syntaxe_des_extensions.1522596638.txt.gz · Dernière modification : 01.04.2018 @ 17:30 de MetallicaMust