Difference between revisions of "User:Esteis"

From Wiki
Jump to navigation Jump to search
(Created my user page with my real name.)
 
 
(15 intermediate revisions by the same user not shown)
Line 1: Line 1:
User page of Esteis; my real name is Sietse Brouwer. I'm an entry-level ConTeXt user.
+
User page of Esteis; my real name is Sietse Brouwer, e-mail address sbbrouwer@—gmail—.com. Somewhat experienced with ConTeXt by now, especially from filling in lots of command reference pages over at [[:Category:Commands]].
 +
 
 +
== Subpages of this page ==
 +
 
 +
* '''[[Special:PrefixIndex/User:Esteis/|All subpages of this page]]'''
 +
 
 +
* [[User:Esteis/Cheat sheet|ConTeXt wiki cheat sheet]]
 +
* [[User:Esteis/XML|XML article]]
 +
 
 +
== TODO ==
 +
 
 +
* Tell people that <nowiki>{{cmd|startnarrower|[left]}}</nowiki> --> {{cmd|startnarrower|[left]}} is now possible.
 +
* Make <nowiki>{{cmdstop|narrower}} that displays as {{cmd|stopnarrower}}, but links to {{cmd|startnarrower}}</nowiki>
 +
* Wiki entries on general {{code|1=key=value}} keys (well, the links to the entries):
 +
** are at {{code|<nowiki>[[Command/keyword:style]]</nowiki>}} (ugly)
 +
** should be at {{code|<nowiki>[[KeyValue/style]]</nowiki>}} (better)
 +
* We have the navbox template at [[Template:navbox]], but still need CSS and JS for it. See [http://en.wikipedia.org/wiki/Wikipedia:WikiProject_Transwiki#MediaWiki_files here].
 +
 
 +
== A design for this wiki ==
 +
 
 +
=== A new command page template ===
 +
 
 +
See [[User:Esteis/New command template]].
 +
 
 +
=== What sort of pages do we have on here? ===
 +
 
 +
* Command documentation ({{cmd|startitemize}}, {{cmd|setupnarrower}}
 +
* Description of mechanisms (heads, captions, itemize, floats, etc.)
 +
* Howto instructions (How to install ConTeXt, how to use text editor X with ConTeXt)
 +
* Snippet collections (make a framebox without borders)
 +
* Example style files
 +
 
 +
* Description of mechanisms which contains a great many miscellaneous examples (e.g. [[Quotes]]).
 +
* MkII examples
 +
* MkIV examples
 +
* Bug workarounds
 +
 
 +
I think the topics, first of all, should get Navboxes. Example from Wikipedia: [http://en.wikipedia.org/wiki/Template:France_topics France navbox], [http://en.wikipedia.org/wiki/Template:Navbox Navbox template]. They can be used to bind together...
 +
* The commands
 +
* The mechanism description pages
 +
* The example style files
 +
* The 'how to do X' snippers
 +
...that are to do with a topic.
 +
 
 +
=== Why do people come here? ===
 +
 
 +
; Getting started
 +
* What is ConTeXt?
 +
* I want to install ConTeXt
 +
* How can I get started on ConTeXt?
 +
* What documentation is available?
 +
 
 +
; Reference pages
 +
* I know a command, and want to look up what it does
 +
* I know what structure I want, and want to look up how to do it
 +
* I want more information on a mechanism.
 +
 
 +
; Development
 +
* I want to report a bug
 +
* I want to learn how to code a command in a ConTeXtic manner (Optional number of arguments, key-value lists, \start...\stop, etc.)
 +
* I want to learn how to read the source code
 +
* I want to join development
 +
* I want to learn about ConTeXts social events (TUG meetings, etc.)
 +
 
 +
; How to edit the wiki itself
 +
* I want to make/edit a command page
 +
* What wiki improvement projects are ongoing?
 +
* I've got this nugget of knowledge, and I want to know where to put it.
 +
*
 +
 
 +
=== Things to do ===
 +
 
 +
# Banners above command pages: "Click here to find out how to edit command pages"
 +
# Work out topics
 +
# Navboxes for the topics
 +
# A way to store examples/snippets. Taggable and searchable.
 +
#* Get all those examples/snippets out of the article pages.
 +
# Redesign the Main Page, with a link to the village pump
 +
# Work out jumpoff pages for "Why do people come here", and put those on the Main Page
 +
 
 +
== Page template: Command reference ==
 +
 
 +
<pre>
 +
{{Reference
 +
|name=XXX
 +
|attributes=
 +
}}
 +
 
 +
== [[Help:Reference|Syntax]] ==
 +
<table cellspacing="4" cellpadding="2" class="cmd">
 +
  <tr>
 +
    <td colspan="2" class="cmd">\XXX<!--
 +
      --><span class="first">[...]</span><!--
 +
      --><span class="second">[...]</span><!--
 +
      --><span class="third">[...]</span><!--
 +
--></td>
 +
  </tr>
 +
  <tr valign="top" class="first">
 +
    <td class="cmd">[...]</td>
 +
    <td>''text''</td>
 +
  </tr>
 +
  <tr valign="top" class="second">
 +
    <td class="cmd">[...]</td>
 +
    <td>''text''</td>
 +
  </tr>
 +
  <tr valign="top" class="third">
 +
    <td class="cmd">[...]</td>
 +
    <td>''text''</td>
 +
  </tr>
 +
</table>
 +
 
 +
== Description ==
 +
 
 +
 
 +
== Example ==
 +
<!-- something like this:
 +
<context source=yes>
 +
...
 +
</context>
 +
Or use <texcode> tags if the example doesn't compile on this wiki
 +
-->
 +
 
 +
== See also ==
 +
<!-- something like this:
 +
* {{cmd|setuphead}}
 +
* {{cmd|strc-sec.mkiv#l299}}
 +
-->
 +
 
 +
== Help from ConTeXt-Mailinglist/Forum ==
 +
All issues with:
 +
{{Forum|{{SUBPAGENAME}}}}
 +
 
 +
[[Category:Commands|XXX]]
 +
</pre>

Latest revision as of 12:28, 24 May 2013

User page of Esteis; my real name is Sietse Brouwer, e-mail address sbbrouwer@—gmail—.com. Somewhat experienced with ConTeXt by now, especially from filling in lots of command reference pages over at Category:Commands.

Subpages of this page

TODO

  • Tell people that {{cmd|startnarrower|[left]}} --> \startnarrower[left] is now possible.
  • Make {{cmdstop|narrower}} that displays as {{cmd|stopnarrower}}, but links to {{cmd|startnarrower}}
  • Wiki entries on general key=value keys (well, the links to the entries):
    • are at [[Command/keyword:style]] (ugly)
    • should be at [[KeyValue/style]] (better)
  • We have the navbox template at Template:navbox, but still need CSS and JS for it. See here.

A design for this wiki

A new command page template

See User:Esteis/New command template.

What sort of pages do we have on here?

  • Command documentation (\startitemize, \setupnarrower
  • Description of mechanisms (heads, captions, itemize, floats, etc.)
  • Howto instructions (How to install ConTeXt, how to use text editor X with ConTeXt)
  • Snippet collections (make a framebox without borders)
  • Example style files
  • Description of mechanisms which contains a great many miscellaneous examples (e.g. Quotes).
  • MkII examples
  • MkIV examples
  • Bug workarounds

I think the topics, first of all, should get Navboxes. Example from Wikipedia: France navbox, Navbox template. They can be used to bind together...

  • The commands
  • The mechanism description pages
  • The example style files
  • The 'how to do X' snippers

...that are to do with a topic.

Why do people come here?

Getting started
  • What is ConTeXt?
  • I want to install ConTeXt
  • How can I get started on ConTeXt?
  • What documentation is available?
Reference pages
  • I know a command, and want to look up what it does
  • I know what structure I want, and want to look up how to do it
  • I want more information on a mechanism.
Development
  • I want to report a bug
  • I want to learn how to code a command in a ConTeXtic manner (Optional number of arguments, key-value lists, \start...\stop, etc.)
  • I want to learn how to read the source code
  • I want to join development
  • I want to learn about ConTeXts social events (TUG meetings, etc.)
How to edit the wiki itself
  • I want to make/edit a command page
  • What wiki improvement projects are ongoing?
  • I've got this nugget of knowledge, and I want to know where to put it.

Things to do

  1. Banners above command pages: "Click here to find out how to edit command pages"
  2. Work out topics
  3. Navboxes for the topics
  4. A way to store examples/snippets. Taggable and searchable.
    • Get all those examples/snippets out of the article pages.
  5. Redesign the Main Page, with a link to the village pump
  6. Work out jumpoff pages for "Why do people come here", and put those on the Main Page

Page template: Command reference

{{Reference
|name=XXX
|attributes=
}}

== [[Help:Reference|Syntax]] ==
<table cellspacing="4" cellpadding="2" class="cmd">
  <tr>
    <td colspan="2" class="cmd">\XXX<!--
      --><span class="first">[...]</span><!--
      --><span class="second">[...]</span><!--
      --><span class="third">[...]</span><!--
 --></td>
  </tr>
  <tr valign="top" class="first">
    <td class="cmd">[...]</td>
    <td>''text''</td>
  </tr>
  <tr valign="top" class="second">
    <td class="cmd">[...]</td>
    <td>''text''</td>
  </tr>
  <tr valign="top" class="third">
    <td class="cmd">[...]</td>
    <td>''text''</td>
  </tr>
</table>

== Description == 


== Example ==
<!-- something like this:
<context source=yes>
...
</context>
Or use <texcode> tags if the example doesn't compile on this wiki
-->

== See also ==
<!-- something like this:
* {{cmd|setuphead}}
* {{cmd|strc-sec.mkiv#l299}}
-->

== Help from ConTeXt-Mailinglist/Forum ==
All issues with:
{{Forum|{{SUBPAGENAME}}}}

[[Category:Commands|XXX]]