MetallicaMust

Metallica et collection.

Outils pour utilisateurs

Outils du site


wiki:syntaxe_des_extensions

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
wiki:syntaxe_des_extensions [02.04.2018 @ 21:10] – Refonte de la page MetallicaMustwiki: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%>
-Cette page est à complété au compte goute.+Page en développement. ATTENTION, Tous les liens n'ont pas été mis-à-jour ! 
 + 
 +--- //[[user:MetallicaMust|MetallicaMust]] ([[discussion:user:MetallicaMust|discussion]]) le 01.04.2018 @ 13:23//
 </WRAP> </WRAP>
  
-[[doku>fr:dokuwiki|DokuWiki]] utilise un langage de balisage simple, qui essaie de rendre les fichiers de données aussi lisibles que possible. Cette page contient toutes les syntaxes possibles offertes par les extensions. Regardez simplement le code source de cette page en cliquant sur le bouton //Modifier cette page//. Si vous souhaitez essayer quelque chose, rendez-vous dans la page du [[playground:playground|bac à sable]]. La page [[:wiki:syntax|Syntaxe de mise en page]] vous informe sur les syntaxes de base. Les balises les plus simples sont parfois accessibles depuis la barre d'outils de l'éditeur. 
  
-===== Info plugin =====+[[doku>fr:dokuwiki|DokuWiki]] utilise un langage de balisage simple, qui essaie de rendre les fichiers de données aussi lisibles que possible. Cette page contient toutes les syntaxes possibles offertes par les extensions. Regardez simplement le code source de cette page en cliquant sur le bouton //Modifier cette page//. Si vous souhaitez essayer quelque chose, rendez-vous dans la page du [[playground:playground|bac à sable]]. La page [[:wiki:syntax|Syntaxe de mise en page]] vous informe sur les syntaxes de base. Les balises les plus simples sont également facilement accessibles depuis la barre d'outils de l'éditeur.
  
-Page officiel de cette extension : [[doku>plugin:info|Info plugin]].\\ +===== Info Plugin =====
-Cette extension fait partie de DokuWiki.\\ +
-Aucune dépendance et pas de conflit connu.+
  
-===== Random include (Randominc) plugin =====+<code> 
 +~~INFO:keyword~~ 
 +</code> 
 +  * **keyword** can be one of: 
 +    * //syntaxmodes// --- Displays the complete list of [[doku>devel:parser|parser modes]] together with their [[doku>devel:parser#order_of_adding_modes_important|getSort()]] values. See also [[doku>fr:devel:syntax_plugins|syntax plugins]]. 
 +    * //syntaxtypes// --- Displays which [[doku>fr:devel:syntax_plugins#syntax types]] are used by available plugins. The syntax type determine which syntax may be nested. 
 +    * //syntaxplugins// --- Displays a list of available [[doku>fr:plugins?plugintype=1|syntax]] plugins.  
 +    * //adminplugins// --- Displays a list of available [[doku>fr:plugins?plugintype=2|admin]] plugins. 
 +    * //actionplugins// --- Displays a list of available [[doku>fr:plugins?plugintype=4|action]] plugins.  
 +    * //rendererplugins// --- Displays a list of available [[doku>fr:plugins?plugintype=8|render]] plugins.  
 +    * //helperplugins// --- Displays a list of available [[doku>fr:plugins?plugintype=16|helper]] plugins.  
 +    * //helpermethods// --- Displays documentation of helper plugin class methods along with parameters and return values. One example of a helper plugin supporting this is [[doku>fr:plugin:pagelist]]. 
 +     
 +===== Random Include Plugin =====
  
-Page officiel de cette extension : [[doku>plugin:randominc|Randominc plugin]].\\ +Enclose the namespace from where to select the page in double curly bracketsRefer to [[#Include plugin]] for detailed information here are only described the added functionallities.
-Dépendance : [[#Include plugin]].\\ +
-Pas de conflit connu.+
  
-===== Blog Plugin =====+  {{randominc>[ns]#[section]&[flags]}}
  
-Page officiel de cette extension : [[doku>plugin:blog|Blog Plugin]].\\ +[ns] | namespace from which select the page to include |
-Dépendance : [[#Include plugin]] et [[#Pagelist plugin]].\\ +
-Pas de conflit connu.+
  
-===== HtmlMetaTags plugin ===== 
  
-Page officiel de cette extension : [[doku>plugin:htmlmetatags|HtmlMetaTags plugin]]\\ +The plugin offers two syntaxes, ''%%{{randominc>...}}%%'' and ''%%{{randomincsec>...}}%%''.
-Aucune dépendance et pas de conflit connu.\\ +
-Similitude : [[#Meta plugin]]. +
-     +
-===== BBCode plugin =====+
  
-Page officiel de cette extension : [[doku>plugin:bbcode|BBCode plugin]].\\ +  * ''randominc'' works as [[#Include plugin]] syntax of Include Plugin
-Aucune dépendance et pas de conflit connu.+  * ''randomincsec'' //should// work as [[#Include plugin]] syntax.
  
-===== Snippets plugin =====+===== htmlmetatags plugin ===== 
 +===== Snippets Plugin ===== 
 +===== Bookcreator Plugin ===== 
 +===== talkpage plugin ===== 
 +===== Meta plugin ===== 
 +===== Box Plugin ===== 
 +===== Tag Plugin ===== 
 +===== Translation Plugin ===== 
 +===== Include plugin =====
  
-Page officiel de cette extension : [[doku>plugin:snippets|Snippets plugin]].\\ +==== Examples ====
-Conflit : [[doku>plugin:cryptsign|Cryptsign plugin]] et [[doku>plugin:move|Move plugin]].\\ +
-Aucune dépendance.+
  
-=====  BookCreator plugin =====+''%%{{page>wiki:syntax#Tables}}%%'' will include the section about tables of the syntax page.
  
-Page officiel de cette extension : [[doku>plugin:bookcreator|BookCreator plugin]].\\ +''%%{{namespace>project_foo}}%%'' will include all pages in the ''project_foo'' namespace.
-Conflit : [[doku>plugin:projects|Projects plugin]].\\ +
-Dépendance : [[#DW2PDF plugin]], [[#Odt plugin]] et [[#Text plugin]].+
  
-===== Talkpage plugin =====+''%%{{page>blog:mypage&tags&comments}}%%'' will include the page ''blog:mypage'' and show the tags from the [[doku>plugin:tag|tag plugin]] and the number of comments from the [[doku>plugin:discussion|discussion plugin]]. Both plugins need to be installed for this example.
  
-Page officiel de cette extension : [[doku>plugin:talkpage|Talkpage plugin]].\\ +''%%{{tagtopic>testtag}}%%'' will include all pages with the tag ''testtag'', the [[doku>plugin:tag|tag plugin]] plugin needs to be installed for this example.
-Aucune dépendance et pas de conflit connu.+
  
-===== Meta plugin =====+==== Syntax ====
  
-Page officiel de cette extension [[doku>plugin:meta|Meta plugin]].\\ +Simply enclose the ID of the page to be included in double curly brackets:
-Aucune dépendance et pas de conflit connu.\\ +
-Similitude : [[#HtmlMetaTags plugin]].+
  
-===== Box plugin =====+  {{page>[id]&[flags]}} 
 +  {{section>[id]#[section]&[flags]}} 
 +  {{namespace>[namespace]#[section]&[flags]}} 
 +  {{tagtopic>[tag]&[flags]}}
  
-Page officiel de cette extension : [[doku>plugin:box|Box plugin]].\\ +[id] | page ID of the page to include; some [[#macros]] are possible; shortcuts are resolved ('':'', ''.'', ''..'') | required | 
-Conflit : [[doku>plugin:box2|Box2 plugin]], [[doku>plugin:boxes_mod|Modified boxes plugin]], [[doku>plugin:boxwh|Boxwh plugin]] et [[doku>plugin:workflow|Workflow plugin]].\\ +[section] limits the included page to a specific section and its subsections | optional; default is the whole page this can be used with namespace (if matches)| 
-Similitude : [[#Wrap plugin]].+[tag]|include pages with tag topic tagrequires [[plugin:tag]] |required | 
 +^ [flags] | flags delimited by ''&'', see [[#Configuration and Flags|flags]] | optional |
  
-(A garder sous le coude :[[doku>plugin:note|Note plugin]]).+The plugin offers four syntaxes, ''%%{{page>...}}%%'' , ''%%{{section>...}}%%'' , ''%%{{namespace>...}}%%'' and ''%%{{tagtopic>...}}%%''.
  
-===== Editor plugin =====+Section is aimed more at including sections, page at including whole pages and namespace at including whole namespaces. Tagtopic includes all pages with a ''tagtopic'' ''tag''.
  
-Page officiel de cette extension : [[doku>plugin:editor|Editor plugin]].\\ +==== Configuration and Flags ====
-Pas de conflit connu.\\ +
-Dépendance : [[#Include plugin]] et [[#tag plugin]].+
  
-===== Tag plugin =====+The plugin can be configured in the DokuWiki configuration manager available in the admin menu. These settings also affect the [[plugin:blog]] plugin which uses the include plugin to generate the blog page. For most settings there are flags that allow to override the setting. Some features are only available as flag.
  
-Page officiel de cette extension : [[doku>plugin:tag|Tag plugin]].\\ +^ Configuration option ^ Flags ^ Description ^ 
-Pas de conflit connu.\\ +^ ''noheader'' | ''noheader''/ (''show'')''header'' | Don't display the header of the inserted section | 
-Dépendance : [[#Pagelist plugin]].+^ ''firstseconly'' | ''firstsec''(''tion'')''only''/ ''fullpage'' | Display only the first section of the included page | 
 +^ ''readmore'' | ''readmore''/''noreadmore'' | Show "read more" link in case of firstsection only | 
 +^ ''showtaglogos'' | - |Show/hide an image for the first tag (if the page has tags) | 
 +^ ''showfooter'' | ''footer''/''nofooter'' |Show/hide page footer below the included page | 
 +^ ''showlink'' | ''link''/''nolink'' | Makes the first headline of a included page/section a link to the included page/section | 
 +^ ''showpermalink'' | ''permalink''/ ''nopermalink'' | Show/hide a permalink to the included page in the page footer | 
 +^ ''showdate'' | ''date''/''nodate'' | Show/hide creation date of the page in the page footer | 
 +^ ''showmdate'' | ''mdate''/''nomdate'' | Show/hide modification date of the page in the page footer | 
 +^ ''showuser'' | ''user''/''nouser'' | Show/hide user name of the page creator in the page footer | 
 +^ ''showcomments'' | ''comments''/''nocomments'' | Show/hide number of comments in the page footer (requires the [[plugin:discussion]] plugin) | 
 +^ ''showlinkbacks'' | ''linkbacks''/''nolinkbacks'' | Show/hide number of linkbacks in the page footer (requires the [[plugin:linkback|linkback]] or [[plugin:backlinks2]] plugin) | 
 +^ ''showtags'' | ''tags''/''notags'' | Show/hide tags in the page footer (requires the [[plugin:tag]] plugin) | 
 +^ ''showeditbtn'' | ''editbtn'' or ''editbutton''/''noeditbtn'' or ''noeditbutton'' | Show/hide edit button below the included page | 
 +^ ''doredirect'' | ''redirect''/''noredirect'' | Redirect back to original page after an edit | 
 +^ ''usernamespace'' | - | Namespace for user pages (see ''showuser'' configuration) (default ''user'') | 
 +^ ''doindent'' | ''indent''/''noindent'' | Indent included pages relative to the section of the page they get included in | 
 +^ ''linkonly'' | ''linkonly''/''nolinkonly'' or ''include_content'' | Display only a link instead of the whole page content | 
 +^ '' title''| ''title''/''notitle'' | Show the title instead of the page id| 
 +^ ''pageexists''| ''pageexists''/ ''nopageexists'' | Only list page ids of existing pages (see ''existlink'')| 
 +^ -| ''existlink'' | Display a link and do so only if page page-id exists (combination of ''linkonly'' and ''pageexists'')| 
 +^ ''parlink''| ''parlink''/''noparlink'' | (Don't) put the link into a paragraph environment (for inline lists) | 
 +^ ''order'' | ''order=OPTION'' | Ordering criteria for namespace includes, possible optionspage ID (''id''), title (''title''), date created (''created''), date modified (''modified''), [[plugin:indexmenu#metadata_tag_syntax|indexmenu sort order]] (''indexmenu''), custom sort order using the ''%%{{include_n>[number]}}%%'' on the pages that are included similar to the indexmenu tags (''custom''). | 
 +^ ''rsort'' | ''rsort''/''sort'' | Reverse the sort order in namespace includes. | 
 +^ ''depth'' | ''depth=DEPTH'' | The maximum depth of subnamespaces of which pages are included in namespace includes, default is ''1'' for only the specified namespace, ''0'' is for unlimited depth. | 
 +^ - | ''inline'' | Don't close/open sections when including a page. This flag should be used when the include syntax is used inside other syntax elements like lists or tables or inside other plugin syntax. | 
 +^ - | ''beforeeach=ENTITY''/ ''aftereach=ENTITY'' | Display an [[:entities|entity]] before/after each included pageThe entity is printed outside the section/include environment, this is mainly for adding custom HTML code (when the text isn't recognized as entity it is directly displayed but escaped so you can't directly use HTML code here). | 
 +^ ''safeindex''| - | Don't index metadata of included pages that are non-public. This can cause problems with other plugins that use the metadata index and can be safely disabled in wikis where the permissions of the included pages match the permissions of the parent pages. |
  
-===== Translation plugin ===== 
  
-Page officiel de cette extension [[doku>plugin:translation|Translation plugin]].\\ +=== Examples===
-Conflit : [[doku>plugin:autotranslation|AutoTranslation plugin]], [[doku>plugin:multilingual|Multilingual plugin]] et [[doku>plugin:translation3|translation3 plugin]].\\ +
-Aucune dépendance.+
  
-===== Include plugin ===== 
  
-Page officiel de cette extension : [[doku>plugin:include|Include plugin]].\\ +  {{page>concept&firstseconly&footer}} 
-Conflit : [[doku>plugin:datepicker|Datepicker plugin]], [[doku>plugin:editsections2|Editsections2 plugin]], [[doku>plugin:header2|Header2 plugin]], [[doku>plugin:header3|Header3 plugin]], [[doku>plugin:mediasyntax|MediaSyntax plugin]], [[doku>plugin:multiselect|Multiselect plugin]], [[doku>plugin:numberedheadings|Numbered headings plugin]], [[doku>plugin:outliner|Outliner plugin]] et [[doku>plugin:rowmove|Rowmove plugin]].\\ +  {{page>mypage&noindent}} 
-Dépendance : [[#Tag plugin]].+  {{namespace>myns&order=modified}} 
  
-===== Pagelist plugin =====+==== Macros ====
  
-Page officiel de cette extension [[doku>plugin:pagelist|Pagelist plugin]].\\ +Simple macros are possible to serve a page on a per user or per date base. These are:
-Aucune dépendance et pas de conflit connu.+
  
 +^ @USER@  | username |
 +^ @NAME@  | full name of user |
 +^ @GROUP@ | first group the user belongs to |
 +^ @YEAR@  | 4-digit year |
 +^ @MONTH@ | 2-digit month |
 +^ @WEEK@ |2-digit ISO week number |
 +^ @DAY@   | 2-digit day |
 +^ @DATE<expr>@ | use a calculated date instead of today in date macros |
  
-===== DW2PDF plugin =====+<expr> in **''@DATE<expr>@''** can be one of:
  
-Page officiel de cette extension : [[doku>plugin:dw2pdf|DW2PDF plugin]].\\ +^ PYEAR | previous year 
-Conflit : [[doku>plugin:inlineeditor|Inline editor plugin]] et [[doku>plugin:subjectindex|SubjectIndex plugin]].\\ +^ NYEAR next year 
-Aucune dépendance.+^ PMONTH | previous month | 
 +^ NMONTH | next month | 
 +^ PWEEK | previous week | 
 +^ NWEEK | next week | 
 +^ YESTERDAY | yesterday's date | 
 +^ TOMORROW | tomorrow's date |
  
-===== ODT plugin =====+=== Examples: ===
  
-Page officiel de cette extension : [[doku>plugin:odt|ODT plugin]].\\ +  {{page>@MONTH@:@DAY@:birthdays}} 
-Conflit : [[doku>plugin:header2|Header2 plugin]], [[doku>plugin:inlineeditor|Inline editor plugin]] et [[doku>plugin:quickedit|Quickedit plugin]].\\ +includes the page ''birthdays'' in namespace <month>:<day>: eg. ''10:15: birthdays'' for the 15th of october.
-Aucune dépendance.+
  
-===== Gallery plugin =====+  {{page>@USER@:message}} 
 +incudes the page ''message'' from the namespace <user> of the logged in user
  
-Page officiel de cette extension : [[doku>plugin:gallery|Gallery plugin]].\\ +  {{page>foo@DATENWEEK@@YEAR@:@WEEK@}} 
-Conflit : [[doku>plugin:galleryv1.5|Gallery v1.5 plugin]].\\ +includes the page <weeknofrom the namespace ''foo<year>'' with next week's date  e.g foo2012:01 for the 27th of december 2011
-Aucune dépendance.+
  
-===== Wrap plugin =====+===== Dw2Pdf plugin ===== 
 +===== Open Document Plugin ===== 
 +===== Gallery Plugin ===== 
 +===== Wrap Plugin =====
  
-Page officiel de cette extension : [[doku>plugin:wrap|Wrap plugin]].\\ 
-Aucune dépendance et pas de conflit connu.\\ 
-Similitude : [[#Wrap plugin]]. 
wiki/syntaxe_des_extensions.1522696210.txt.gz · Dernière modification : 02.04.2018 @ 21:10 de MetallicaMust