SDL Wiki

Style Guide: New Pages

This guide provides instructions for adding new pages to this wiki.

Most of the pages in the SDL API already exist and will only require editing as time goes on. See the other Style Guides for details on editing existing pages. But, if you encounter a component of the API that should have a page in this wiki but does not, this guide is your starting point.

General Guidelines

This wiki contains the following page types:

||API pages||pages describing the various Hints, Enumerations, Structures, and Functions of SDL||
||Category pages||pages that list all parts of the API related to a specific topic, or category, and may contain some introductory discussion about the topic||
||Tutorials||pages that help people use SDL||
||Administrative pages||these include most of the other pages linked in the left sidebar, such as the FrontPageIntroductionSupport, and Contributing pages||

Important! It is highly unlikely that you will be creating new Administrative pages. If you feel that something of this nature is warranted, or if you feel an Administrative page needs editing, please contact us at <<MailTo(ANTI SPAM wiki AT libsdl DOT org)>> or post about it in a [Contributing#list|Mailing List]] or [Forum.

Action - Tutorials: Please see the Tutorials Style Guide if you wish to create a new Tutorial page.

Action - Other: At present, all of the categories (headers) that will have a Category page (see a list here) and all of the Hints, Enumerations, Structures, and Functions that will have an API page in this wiki have been created. However, since SDL is a dynamic entity, should it become necessary to create a new Category or API page, please follow the instructions in the remainder of this Style Guide.

Please only create a new Category or API page if you are certain that it does not already exist and that it fits with and will enhance this documentation.

~-Return to Table of Contents-~

Creating A New Page

The basic steps required to create a new page in this wiki are the same regardless of page type. If you have determined that it is necessary to create a new page, begin here and use the following guidelines as they apply to your page type:

Action 1: Create an address for the page.

How: Type the following into the address bar and replace PageName with the name of your page.  Press Enter to begin creating the page.

 ```

https://wiki.libsdl.org/PageName ```

~-Note: There are several ways to create a new page address. You may choose another method if you prefer.-~

Note: The convention in this wiki is that the name of the page is also the address of the page and that CamelCase is preferable to blank spaces.
Page addresses are case-sensitive.

Example: The address for the page SDL_BuildAudioCVT() is

```https://wiki.libsdl.org/SDL_BuildAudioCVT```

Important! Be careful to name and spell accurately when creating a new page! You cannot delete a page or edit a page address after the page is created and saved.
||<( |2 30%>If you discover a typo in the address __prior to saving the page__||Action: DO NOT SAVE THE PAGE!  Copy any of your contents you'd like to save, Cancel or close the page, and start over.
Paste your contents into the new page and continue editing.||
||Note: Your old page and address will not be saved.||
||<( |2>If you discover a typo in the address __after you saved the page__||Action: Send a message to <<MailTo(ANTI SPAM wiki AT libsdl DOT org)>> requesting a correction.||
||Note: You will not be able to correct it yourself.||
Note: If you type in an address and land on an existing page then most likely you do __not__ need to create a page but may need to edit the existing one instead.  If a new page is still required you will need to select a different address.

Action 2: Choose the correct Template.

How: If you have chosen a unique address in Action 1 above then you will arrive at a page that has the following at the top followed by a table with 2 columns.
 ||This page does not exist yet. You can create a new empty page, or use one of the page templates.

Create new empty page||

Use the following table to determine which template to select.

||<( 30%>If you need to create a new __Category page__||Action: See Creating a Category Page below for further details||
||<( 30%>If you need to create a new __API page__||Action: See Creating an API page below for further details||

Note: When editing a new page the default method is the Text editor.  If you prefer to use the GUI editor click GUI/Text Mode in the left column to switch to the GUI editor on the new page.

Note: For information on markup used in this wiki see SGWikiBasics.

~-Return to Table of Contents-~

Creating a Category Page

Action 1: Select CategoryTemplate in the LEFT column of the table.

Action 2: Follow the commented instructions (after ## at the beginning of a line) on the template page and use other Category pages as examples. There is no special Category Style Guide. Contact us if you need help or have questions.

~-Return to Table of Contents-~

Creating an API Page

Action 1: In the LEFT column of the table click on:

||SDLEnumTemplate||to create a page for an Enumeration or Hint||
||SDLFunctionTemplate||to create a page for a Function||
||SDLStructTemplate||to create a page for a Structure or Union||

Action 2: There are some very basic instructions commented (after ## at the beginning of a line) into the 3 templates, but these will be inadequate in most cases. Depending upon the type of API page, see the appropriate Style Guide for further details.

~-Return to Table of Contents-~

<<Include(SGWikiBasics, , , from="Start SG Include here.", to="##End SG Include here.")>>


[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.