3,897
edits
Changes
Jump to navigation
Jump to search
{{todo|Warning: explain here the use of ToDo category.}}
no edit summary
''This page is about editing pages on this wiki in general. For editing command reference pages, also see [[Help:Reference]].''
== General ==
|}
=== Linking to parameter value description pages ===
In ConTeXt many of the {{code|1=key=value}} parameters are common across commandshave predefined value types, so this wiki intends to have separate description pages for those parameters. Those are not linked from the text, in general, but they are linked from the syntax tables on command description pages. ([[Command/setupframed|Example]].) The linking is achieved with <nowiki>{{key|alternative}}</nowiki>, which expands to [[Command/keyword:alternative|<nowiki>[[Command/keyword:alternative]]</nowiki>]]. Nearly all the target pages do not exist yet, but don't let that stop you from linking to them. We'll get around to filling them in.
=== Other inline code ===
For in-line markup of code, commands, parameters, etc. in running text use <nowiki>{{code|some code}}</nowiki>. If there are equality signs in the code, use e.g. <nowiki>{{code|1=some=code}}</nowiki>, because the wiki templating software interprets all text up to the first equality sign as a template parameter name. Please do use the {{code|code}} template instead of the {{code|<code>}} tags, as templates are much easier to change.
''Note:'' except in [[Command]] documentation pages, where the fluidity of templates is actually a disadvantage.
In [[Command]] pages {{code|<code>}} is required.
{| class=wikitable
* '''Links to:''' http://modules.contextgarden.net/t-lettrine
* '''Looks like:''' [[modules:t-bnf|Lettrine module]]
=== Some other templates ===
There are a few other templates that may be useful:
* <tt><nowiki>{{todo|}}</nowiki></tt> adds a page to the [[:Category:ToDo|ToDo list]]. This is intended for wiki pages that need more work done.
* <tt><nowiki>{{howto}}}</nowiki></tt> adds a page to the [[:Category:How to|How to list]]. This is for wiki pages that you would like to be on the [[:Category:ToDo|ToDo list]], but where you are not sure whether the current page is the right place to add the documentation.
* <tt><nowiki>{{bug|}}}</nowiki></tt> adds a page to the [[:Category:Bugreports|Bug reports list]]. This is for problems you find in ConTeXt and/or the ConTeXt installation on the server. ''Not for wiki page problems!'' (you should fix those yourself, or add one of the two previous templates.)
{| class=wikitable
! scope=col width=360 style="text-align: left"| You type
! scope=col width=360 style="text-align: left"| You see
|- style="vertical-align: top"
|
* <tt><nowiki>{{todo|this page needs more work}}</nowiki></tt>
|
* {{todo|this page needs more work}}
|- style="vertical-align: top"
|
* <tt><nowiki>{{howto}}</nowiki></tt>
|
* {{howto}}
|- style="vertical-align: top"
|
* <tt><nowiki>{{bug|this feature does not work on the wiki}}</nowiki></tt>
|
* {{bug|this feature does not work on the wiki}}
|}
== Block elements ==
|- style="vertical-align: top"
| <pre>
<context mode="mkiv " source="yes " text="This produces:">
The wiki also contains ConTeXt Mark IV: \crlf
\contextversionnumber
</context>
</pre>
| <context mode="mkiv " source="yes " text="This produces:">
The wiki also contains ConTeXt Mark IV: \crlf
\contextversionnumber
=== Displaying a ConTeXt command syntax ===
If you want to show the calling convention(s) of a ConTeXt command, you can use <code><nowiki><syntax> ... </syntax></nowiki></code>. This is particularly useful in a "Command" page.
The <nowiki><syntax></nowiki> tag accepts two attributes:
