Changes

Jump to navigation Jump to search
2,850 bytes added ,  13:05, 2 July 2020
'''This page is about editing pages on this wiki in general. For Formatting help editing command reference pages, also see [http://www.mediawiki.org/wiki/[Help:Formatting wwwReference]].mediawiki.org/wiki/Help:Formatting]''' {{todo|Warning: explain here the use of ToDo category.}}
== General ==
=== May I edit pages without signing in? ===
Yes, you may (mainly because we are still glad if the users who hate signing in can nevertheless contribute), but you are highly <b>discouragedhighly encouraged</b> to do so. Please, sign in before contributing if possible. Even if you use your account has a username/nickname with no resemblance to your real name, this is still better than not signing in at allwhile editing.
=== How What commands do I use to edit the first pagethis wiki? ===
First page is protected to avoid spammers. HoweverIn order of increasing generality, you can still edit it (lethave a look at: * Mediawiki's hope for stupid spammers)[http://www.mediawiki. Type org/wiki/Help:Formatting guide to formatting]* Mediawiki'''Templates [http://meta.wikimedia.org/wiki/Help:Editing guide to editing in general]* [http:Main Page''' after contextgarden//meta.wikimedia.netorg/wiki/ MediaWiki_User%27s_Guide Mediawiki User Guide]* There are some special commands and edit that templatetemplates available on this wiki; they are described on the rest of this page.
=== How do I sign when posting a comment? ===
* '''You type:''' <code><nowiki>--~~~</nowiki></code> will expand into <nowiki>(three tildes)* '''Looks like:''' --[[User:YourusernameEsteis|YournicknameEsteis]]</nowiki>, so basically your <b>nickname</b> will be shown* <code><nowiki>~~~~</nowiki></code> will also add a <b>timestamp</b> next to your nickname So you will usually write <code><nowiki>--~~~</nowiki></code> or <code><nowiki>--~~~~</nowiki></code>
* '''You type:''' <code><nowiki>--~~~~</nowiki></code> (four tildes)* '''Looks like:''' --[[SpecialUser:Contributions/174.101.111.175Esteis|174.101.111.175Esteis]] 0816:1137, 16 May 2010 14 June 2012 (UTCCEST)Sarah Rose Burch was here.
&& She likes it rough. Ooh yeah.=== How do I edit the Main Page? ===
If The Main Page is protected to avoid spammers. However, you are a hot lady then hit this chick up! can still edit it (let's hope for stupid spammers). Type '''Template: YeaahMain Page''' after contextgarden. Click belownet/ and edit that template.
http://www.facebook.com/?ref=logo#!/profile.php?id=843257113 Just so you know, yeah. She wants you hot babes. She likes to eat pickles in her spare time!In-line elements ==
&&She likes sweet & sour sauce to spice up her bedroom.=== ConTeXt commands ===
== Pretty printing ==Use the [[Template:cmd|cmd template]] for command names in running text: * <nowiki>{{cmd|mycommand}}</nowiki>, * <nowiki>{{cmd|mycommand|parameters, text, etc.}}</nowiki>That way, you get an automatic link to e.g. {{cmd|startnarrower}}, or {{cmd|startnarrower|[middle]}}.
{| 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>{{cmd|startitemize}}</nowiki></tt>* <tt><nowiki>{{cmd|startnarrower|[middle]}}</nowiki></tt>* <codett><nowiki>'''Bold text'''{{cmd|startcolumns|2=[n=4]}}</nowiki></tt>* <tt><nowiki>{{cmd|section|{First section}}}</nowiki></codett> | * {{cmd|startitemize}}* {{cmd|startnarrower|[middle]}}* {{cmd|startcolumns|2=[n=4]}}* {{cmd|section|{First section}}}|-- '''Bold text'| Forgetting the pipe or the '2='leads to this:* <tt><nowiki>{{cmd|startnarrower[middle]}}</nowiki></tt>* <codett><nowiki>''Italic text''{{cmd|startcolumns|[n=4]}}</nowiki></codett> -- ''Italic text''* <codett><nowiki>----{{cmd|section{First section}}}</nowiki></codett> draws a horizonal rule| * {{cmd|startnarrower[middle]}}* {{cmd|startcolumns|[n=4]}}* {{cmd|section{First section}}}|}
=== In-line elements The &lt;cmd&gt; tag is deprecated. ===----'''<code><nowiki><code></nowiki></code>'''
For in-line markup of codeSometimes, commandswhen editing an older page, parametersyou will see &lt;cmd&gt;\somecommand&lt;/cmd&gt; on this wiki. This is an older, etc. in the running text use <code>deprecated form, and you should turned it into <nowiki><code> ... </code>{{cmd|somecommand}}</nowiki></code>wherever you see it.
''wiki markup''=== Linking to parameter description pages ===
In ConTeXt many {{code|1=key=value}} parameters are common across commands, 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|&lt;code>}} tags, as templates are much easier to change. {| 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"| <xmlcode>In the following examples we use <code>\the {{cmd|framed</code> }} command with the parameters <{{code>|1=background=color</code> }} and <{{code>|1=offset=1cm</code>}}.
</xmlcode>
| style="background-color: white" |In the following examples we use the {{cmd|framed}} command with the parameters {{code|1=background=color}} and {{code|1=offset=1cm}}.|} === Linking to source files === Practically all of ConTeXt''wiki display''s source files are stored in the directory {{code|.../tex/context/base/mkiv}}. There are two templates to link to online copies of the source files.
In Link to the following examples we use most recent version (recommended):* '''You type:''' <codenowiki>\framed{{src|type-akb.tex}}</codenowiki> command with the parameters <code>background=color<* '''Links to:''' https://source.contextgarden.net/tex/context/base/code> and <code>offset=1cm<mkiv/code>type-akb.tex* '''Looks like:''' {{src|type----akb.tex}}
=== Block elements ===----Link to the version stored on contextgarden.net:* '''You type:'''<code><nowiki><pre>[[source:type-akb.tex| type-akb.tex]]</nowiki><* '''Links to:''' http://source.contextgarden.net/code>type-akb.tex* '''Looks like:'''[[source:type-akb.tex|type-akb.tex]]
To dispay verabtim text use <code><nowiki><pre> ... </pre></nowiki></code>.=== Linking to other sections of the wiki ===
* ''wiki markup'You type:''' <nowiki>[[modules:t-lettrine|Lettrine module]]</nowiki>* '''Links to:''' http://modules.contextgarden.net/t-lettrine* '''Looks like:''' [[modules:t-bnf|Lettrine module]]
<xmlcode>== Block elements == === Displaying ConTeXt output (and source) ===<pre>This is an announcement from wiki allows you to type ConTeXt code to obtain a PNG of the mailing list resultant output, with some codeextraneous whitespace cropped. This is very useful for including in-page examples. Below are two simple ones; for more, see [[Help:Context]].
{| class=wikitable! scope=col width=300 style="text-align: left"| You type! scope=col width=300 style="text-align: left"| You see|- style="vertical-align: top"| <pre><context>The wiki is using ConTeXt Mark IV: \crlf\contextversionnumber</context></pre>| <context>The wiki is using ConTeXt Mark IV: \unprotectcrlf\defcontextversionnumber</context>|- style="vertical-align: top"| <pre><context source=yes text="This produces:">The wiki still uses ConTeXt Mark IV: \!test{alfa} crlf\protect contextversionnumber</context>
</pre>
| <context source=yes text="This produces:">The wiki still uses ConTeXt Mark IV: \crlf\contextversionnumber</xmlcodecontext>|}
''wiki display''
=== Displaying a ConTeXt command syntax ===If you want to show the calling convention(s) of a ConTeXt command, you can use <precode><nowiki><syntax> ... </syntax></nowiki></code>. This is an announcement from the mailing list with some codeparticularly useful in a "Command" page.
\unprotect{| class=wikitable! scope=col width=300 style="text-align: left"| You type\def\!test{alfa} scope=col width=300 style="text-align: left"| You see|- style="vertical-align: top"| <pre>\protect <syntax>page</syntax>
</pre>
| <syntax>page</syntax>
|}
----
'''<code><nowiki><texcode></nowiki></code>'''
For displaying === Displaying TeX an or ConTeXt source use <code><nowiki><texcode> ... </texcode></nowiki></code>.alone ===
''wiki markup''For displaying TeX and ConTeXt code use <code><nowiki><texcode> ... </texcode></nowiki></code>.
{| 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"| <xmlcodepre>
<texcode>
\def\person#1#2{{\em #1 (#2)}}
offset=1cm ]{hello world!}
</texcode>
</xmlcodepre''wiki display'' | <texcode>
\def\person#1#2{{\em #1 (#2)}}
offset=1cm ]{hello world!}
</texcode>
----|}
'''<code><nowiki><xmlcode></nowiki></code>'''=== Displaying XML ===
For presenting XML source use <code><nowiki><xmlcode> ... </xmlcode></nowiki></code>.
''wiki markup''{| 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"| <xmlcodepre>
&lt;xmlcode>
<?xml version="1.0"?>
</TeXML>
&lt;/xmlcode>
</xmlcodepre''wiki display'' | <xmlcode>
<?xml version="1.0"?>
<TeXML>
</TeXML>
</xmlcode>
|}
----=== Displaying other verbatim text ===
'''To dispay other verbatim text use <code><nowiki><contextpre> ... </pre></nowiki></code>'''.
Nice local feature of contextgarden allows you to run ConTeXt on the fly {| 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"| <pre><pre>This is some text and the wiki page will include the result of the eneterd some code in the page. See also http://live.contextgarden.net/ for an online ConTeXt.
''wiki markup''\unprotect\def\!test{alfa} \protect &lt;/pre></pre>
| <xmlcodepre><context>\setupcolors [state=start]\framed [background=color, backgroundcolor=green, offset=1cm ]{hello world!}</context></xmlcode>This is some text and some code.
''wiki display'' <context>\unprotect\setupcolors [state=start]def\framed [background=color, backgroundcolor=green, offset=1cm ]{hello world!}</context>---- '''<code>source="yes"</code>''' If you add <code>source="yes"</code> to the <code><nowiki><context></nowiki></code> tag, you have the source and the result displayed. The contents of the attribute <code>text</code> will be inserted between the text and the result. ''wiki markup'' <xmlcode><context source="yes" text="produces">\setupcolors [state=start]\framed [background=color, backgroundcolor=green, offset=1cm ]test{hello world!alfa}</context></xmlcode> ''wiki display'' <context source="yes" text="produces">\setupcolors [state=start]\framed [background=color, backgroundcolor=green, offset=1cm ]{hello world!}protect </context>---- == Links == You can use references to other garden projects. Use the following syntax to create links to the other contextgarden projects: <pre><nowiki> [[source:type-akb.tex| type-akb.tex]] [[modules:t-bnf| bnf module]] [[cmd:goto|\goto]] </nowiki></pre>}
Looks like:* [[source:type-akb.tex| type-akb.tex]] -- source files of ConTeXt* [[modules:t-bnf| bnf module]] -- [http://modules.contextgarden.net third party modules]* [[cmd:goto|\goto]] -- links to the definition of the command{{About this wiki navbox}}

Navigation menu