How you can contribute

From Knot Atlas
Jump to navigationJump to search

There are many possible ways you might want to contribute to the Knot Atlas. This page will tell you where to start!

Fixing mistakes

Editing the manual

See How to Edit this Manual...

Improving the formatting or layout of knot pages

This should be a pretty straightforward, once you know where to go. (If you already have some experience with mediawiki markup from Wikipedia, this should be very easy.)

To modify the layout of a section (note -- your changes will affect all knots that display this section), simply click the 'edit' link on the right side of the page level with the section heading. This will actually edit the template generating this section.

To modify the layout of the entire page (for example, to change the order of the sections), you need to edit the main template. This is slightly harder to get to. First, click edit (at the top of the page) on the knot page you're interested in. Then, below the edit box, you'll see a list of the templates used on the page. You'll be looking for one titled something like Template:Rolfsen Knot Page, or Template:Torus Knot Page, etc. (See Category:Primary Knot Page Template for all of them.) Click on this link, and then select edit once you've reached that page. (The template itself will display as a big mess -- hopefully the wiki source will be easier to understand.)

For more details, see How the knot pages are constructed.

Adding comments or references for the data

Adding more data for an existing invariant

Adding a new invariant

By hand

Using WikiSplice`

By uploading data

Adding a new knot table

Wow! You'll need a bit of everything above, and a little patience. Here are the major steps.

Prepare and upload images

(Optional!) The images will look best if they are all of a uniform size (that is, don't crop the knot images down to a minimal rectangle bounding the knot), and have a transparent background. There's no problem uploading images at a higher resolution than you'll need on either the knot table page, or the individual knot pages, because the Mediawiki software can automatically resize images on demand. You'll then need to name the images. A good way of doing this is to give each image the same name as its knot; for example the image for the torus knot T(5,3) is called T(5,3).jpg. Once the images are prepared and named, you can upload them to the wiki. There is a simple Mathematica notebook Media:UploadingImages.nb (File:UploadingImages.nb) which automates all of these tasks.

Create the knot table

Have a look at the source of The Rolfsen Knot Table, or anything in Category:Knot Table for an idea of how to do this. It'd be nice if you added a link to [[Category:Knot Table]] somewhere. There's a short mathematica notebook, Media:GeneratingKnotTables.nb (File:GeneratingKnotTables.nb), for generating the table entries. (Make sure you read the file description; this notebook has some dependencies!)

Upload data

(Optional!)

Create a splice template for the knot pages

Run the splicer to create the knot pages