• Home Page
• WordPress Lessons
• Getting Started
• Working with WordPress
• Design and Layout
• Advanced Topics
• Troubleshooting
• Developer Docs
• About WordPress

Codex Resources

• Community portal
• Current events
• Recent changes
• Random page
• Help

Codex:Creating a New Page

You will learn how to create a new page in this guide. Before you start on this, you should have read the Guide to creating User Pages and created a User Page for yourself. That allows you to create your own personal testing ground for new pages and rough draft articles.

We cover creating an individual page to add to the Codex below. But first, this commercial:

Overview

You are free to create new articles, but first, please read the Codex Guidelines for creating new pages and Codex Styles. Generally, if you are not sure that you can finish your new article in one sitting, consider creating a rough draft of the article first. Once your work is complete, you can mail the wp-docs mailing list informing others of the new article and requesting feedback. In this guide, you will learn how to create a rough draft, and from there, how to create a new page.

Create a Rough Draft Article

Before posting to the Codex main pages, it may be beneficial for the new article to go through some checking and editing before finding a home among the regular pages. This section describes how you can create a rough draft of an article by creating a Sub-Page of your User Page to work on the draft. If you are not sure about being able to complete what you are starting, or have questions about the article you are working on, creating a rough draft is a good way to begin. Be aware, though, these rough drafts are currently crawled by search engines, so make sure your information is as accurate as possible.

To create a rough draft article on your User Page, the process is similar to creating your User Page:

1. Edit your User Page and add a link to the title of the article. Please follow the article title conventions and guidelines as established in the Codex Guidelines. The link format should be:

[[User:Fredsmith/Title of Article]]

and would look like this when the page is saved:

Because the link is red, it means that the linked page has no content. If you haven't already, add a note to the Summary about what you've done and save your edited User Page by clicking Save Page button below it.

2. Click the red link of the article title and the page will open with a blank editing window. Now it's time to start adding your article content. Use the Codex Guidelines, Codex Styles, Editing Help, and the Sandbox as examples for laying out and formatting your rough draft article page.

3. Add The Following: At the top of the empty page, before you enter your text, please type the following:

When you save or preview the page, the following warning will appear to warn people who find this article on a search engine that it is a rough draft and subject to correction and change.

At the bottom of your new page, please add:

This will create a "flag" that will let people know that this is a new page requiring editing. These two elements provide information to users and volunteers, so when you visit the "what can you do" page, the links there will make your page pop up on the lists as articles needing work.

3. We recommend you write the majority of your article in a word processor or text editing program first so you can spell check and thoroughly proof your article before posting. Simply copy and paste the article into the editing window and then you can start editing and styling it to Codex standards.

As you work, you can see a Preview of the article and how it will look when you save it. Click Show Preview next to the Save Page button and the screen will reload and show your changes in the top part of the screen, with the edit box still below.

Check and Double Check

Before saving the page, here are a few things to check:

Are there any red colored links?

These are "dead links" and will take the visitor to an empty page. Check the link to make sure everything is spelled properly and the link matches EXACTLY to the linked page, with capital letters capitalized and lower case lower. A link to "an Article On WordPress" will not link to an article titled "An article on WordPress".

Is everything spelled right?

It doesn't hurt to copy the final material and paste it in a word processor or text editor and run it through a good spell checker to be sure.

Is the content order right?

Check to make sure the explanation comes first, then the simple material, moving towards the more complex.

Are the sections in order?

Check that the sections are ordered right. If the article has more than four sections, the table of contents box will automatically generate, so check there to see if they are ordered properly as section, subsection, sub-subsection and then back to subsection or section headings. Avoid usage such as section, sub-subsection, subsection, etc. Keep the steps clean.

Double and triple check the code

If you have included code, be sure and do a test run of the code before you publish by copying and pasting the code into a test WordPress page. Sometimes code can get scrambled during the edit process.

Check that code is in tt and not code tags

On the Codex, style example code within a paragraph using the <tt></tt> HTML tags and not the <code></code> tags as the code tags create a blue background behind the text and the tt tags don't.

All styles match the content

When using inline CSS styles and HTML to highlight information, make sure all open HTML tags are closed, and all inline styles are working and closed, too.

Final Steps

After creating your rough draft article, post a note with a link to the article location on the wp-docs mailing list to invite people to review and edit your work. And thank you!

Check your article's Discussion tab occasionally to see if someone has posted a question or note about your article as part of the editing process. Do your best to help them help you create the best article possible, one that is clear and helpful to the WordPress user.

Creating a New Page

To create a new page on the Codex, create a link to the new page title on an appropriate page on the Codex. This will help keep the information on the Codex organized and easily accessible. The link should look something like this, and following the article title conventions and guidelines as established in the Codex Guidelines and Codex Styles.

[[Title of Article]]

When the page is saved, the link will be red. Click the link to access the new page and post the article contents, as listed under Create a Rough Draft above.

Delete the Draft and replace it with the following:

This removes the "rough draft" status of the article and puts it in the "draft/edit" stage, which means it has been checked over for major errors and needs some minor fixing and cleaning.

When the article is ready to leave the draft stage, a member of the Documentation Team will remove the Copyedit tag.

Check your article's Discussion tab occasionally to see if someone has posted a question or note about your article as part of the editing process. Do your best to help them help you create the best article possible, one that is clear and helpful to the WordPress user.