If you have any material you’d like to add to the nLab, be it
or whatever, please do it. It’s quick and easy.
The following gives you a quick idea of how to proceed.
If you feel you can most easily start by modifying an example, look at the template page.
If you feel you want more details, there is more information on the main HowTo page.
First a remark on what not to worry about.
Don’t worry if things don’t come out quite the way you would like them at the first go – the important point is that we have your material in some form - the lab elves will eventually go over the entry and polish it, if necessary, expand it, if necessary, etc.
Never worry about “breaking” or “ruining” anything. Each and every revision is stored and we can always “Rollback” to an earlier version if you make some mistake, e.g. delete material on accident. To see a list of revisions for any page, hit the “History” link at the bottom of any page.
A good way to learn about how to format Lab pages is to look at the source of another page. Near the bottom of each page is a list of “views” (these are different displays of the page) one of which is “source”. This shows the raw code that generates that page and can be cut-and-pasted into another page.
See the latest changes to get an impression for what other contributors are working on currently.
Chances are that you are already familiar with discussions and with posting comments at the n-Cafe. This section describes how you forward material from a blog comment to the Lab.
After you typed your blog comment into the n-Cafe comment edit box and before you hit submit copy the source code of the comment: the text that you just typed.
To paste that into an Lab page, note the “Edit” link at the bottom of each Lab page.
Clicking on this will bring up the edit box.
From here, you simply paste your copied content into the edit box and hit the “Submit” button at the bottom.
Putting your name in the text box next to the “Submit” button is optional but recommended.
This works best if your original comment was composed using the text filter (see the pulldown menu atop the blog comment edit box) called Markdown with itex to MathML. If you’re writing a lot on the Café and want to write on the Lab too, then it may be wise to use that filter by default.
If you wish to copy into the Lab a blog comment after it has been posted – or if you wish to copy other material from elsewhere on the web –, you proceed as above but should be aware of two dangers:
Slightly better is to copy the
XHTML+MathML source (in Firefox : “View” followed by “Page Source”) except that then you are pasting raw
XHTML into the Lab. Whilst this will work, it makes it harder to others to edit afterwards. (But a lab elf will probably come by to clean it up afterwards, so don’t worry about this too much.)
If you do feel like going a bit further, here are some remarks on how to make your material interplay nicely with the whole structure.
If you don’t know where to put your material, Google for “nLab your keywords” to see which entries exist. Better yet, you can Google
and it will look for only keywords on the Lab. (Most other search engines can do similar tricks.)
If the entry with the title that you are looking for does not yet exist, find some entry that is somehow related, go to the edit window as described above and add a line “see also [[your keyword]]”. Then after hitting submit the [[your keyword]] will appear with a clickable question mark. Click on that question mark to create the desired entry.
Add links back and forth between other nLab entries: enclose important keywords in your material in double square brackets [[your keyword]]. That equips them with links to the corresponding other Lab entries. Conversely, go to related Lab entries and add pointers to the entry you just created.
Depending on the kind of material you included, you may feel like adding a reference back to the Café discussion.
The first thing to do that is to get a copy of the Café link, which may be obtained via “permalink” at the bottom of the comment.
The link to this comment on the Café is:
To add a link with the label “Link to the Café”, you need a combination of square brackets and parentheses [Link Name](Link URL) as indicated below:
[Link to the n-Cafe](http://golem.ph.utexas.edu/category/2009/07/the_monads_hurt_my_head_but_no.html#c025514)
This results in a Link to the n-Cafe.
In order that the rest of the Lab crew has a chance of becoming aware of your changes, drop a note about what you did at latest changes. Click on “Start a new discussion,” enter a descriptive title, and then describe the changes you made. Please include a link to the page(s) you edited; the same link syntax
[[page name]] to nlab pages works on the “latest changes” forum. You’ll have to either create an account at the forum, or reply to a captcha in order to post as a guest. For more detailed instructions, see the sticky post at the top of the link.
Congratulations! By helping the Lab, you have done your good deed for the day. All glory comes from daring to begin.
For more information, try the HowTo page.