Wikipedia:Portal/Instructions

From Wikipedia, the free encyclopedia
Jump to: navigation, search

This page gives instructions for the creation of new portals using the box portal layout.

Steps[edit]

To create a new portal on the topic "Topic" using the {{box portal skeleton}} template follow these steps:

1. Create a new page using [[Portal:Topic]] as the title of the page (where "Topic" is the subject of your portal) and enter the following text
{{subst:box portal skeleton}}

Save. At this point you will have a page full of red links; this is correct.

2. Create two subpages, scroll to the bottom of the page and click the template link to the header and footer
  • Save [[Portal:Topic/box-header]] with this text:
{{Portal:Box-header | title={{{1}}} 
|editpage={{{2}}} 
|border=#aaaaaa           <!-- This is the color of the borders around Box Sections -->
|titleforeground=white    <!-- This is the color of the Box Section Title Bar text -->
|titlebackground=#aaccff  <!-- This is the color of the Box Section Title Bar -->
|background=#f9f9ff       <!-- This is the color of the Box Section background -->
|foreground=black}}       <!-- This is the color of the Box Section text -->
  • Save [[Portal:Topic/box-footer]] with this text:
{{Portal:box-footer | {{{1}}} }}
3. Return to your portal page Portal:Topic and begin editing (general instructions on editing a portal are below). Basically follow the red links to create sub-pages that will fill the boxes.
4. Place a link to your portal at the top of the appropriate article (of the same name) by placing a {{portal }} there. If the article has portals already listed or you have created more than one portal for the article, use {{ portal | Topic | portal 2 name| portal 3 name}}.

For an explanation of how and why this format works go here.

5. List your new portal in the Directory of portals.
6. Announce your new portal on the community bulletin board.
7. Update {{Number of portals}}
At this point, you have created a Portal under construction. It is a framework with a lot of red links where content should go. A fair amount of work is still necessary to turn a skeleton portal into one ready for browsing.
8. Edit the portal text. (See Customisation and editing below for instructions.)
9. When the portal is complete and of good quality:

Customization and editing[edit]

The box portal allows you to edit the portal without editing the main portal page. Simply follow the blue links to the sub pages and enter the information there. These sub-pages will be displayed on the main page.

Adding a section (box)[edit]

If you wish to add a section (box) using the regular codes, go to your portal page and simply type in:

 {{/box-header| 1 | 2 }}
 {{   3   }}
 {{/box-footer| 4 }}

where

  • "1" is the box title
  • "2" is the article to be linked to. This will appear right under the title bar. You may omit this parameter if you don't want an edit link to appear, but you must not omit the pipe, for example:
    • {{/box-header | Selected article | Portal:Computer and video games/Selected}}
    • {{/box-header | Selected article | }} (no edit link param, note pipe still in place)
  • "3" is again the article to be linked to (this will appear as a red link until first edited), for example:
    • {{/Featured}}
  • "4" is a link that you'd like to display at the bottom-right corner of the box. You may omit this parameter if you don't want an edit link to appear, but you must not omit the pipe, for example:
    • {{/box-footer | [[Computer and video games|More about Computer and video games...]]}}
    • {{/box-footer | }} (no bottom-right param, note pipe still in place)

Other methods of adding a section[edit]

Other methods of adding a section are adding Template:Random portal component or Template:Random portal component with nominate. see their documentation .

Example 1[edit]

The following code:

<div style="float:right; width:50%;">
{{/box-header|A random title|Portal:Test/Selected article}}
{{/Selected article}}
{{/box-footer|[[Lorem ipsum|More about Lorem ipsum...]]}}
</div>

results in:

Portal:Test/box-header Portal:Test/Selected article Portal:Test/box-footer


Example 2[edit]

The following code:

<div style="float:right; width:50%;">
{{/box-header|A random title|}}
   The following text will appear in the [[box]]. This text can be placed on 
    the [[Wikipedia:Portal|portals]] main page and edited there. Or, 
    alternately placed on a sub-page of the portal, which is explained below.
{{/box-footer|[[Lorem ipsum|More about Lorem ipsum...]]}}
</div>

Portal:Test/box-header The following text will appear in the box. This text can be placed on the portals main page and edited there. Or, alternately placed on a sub-page of the portal, which is explained below. Portal:Test/box-footer

...will result in what is displayed to the immediate right.

The exact same code, used at other portals, will create a box with the exact same content, but the colors may be completely different. This is because each portal has templates at:

  1. "Portal:insertname/box-header" (e.g. [1])
  2. "Portal:insertname/box-footer" (e.g. [2])

that add color information, and the pass all the work along to the Portal:box-header and Portal:box-footer templates, which compose everything into a standards-compliant and cross-browser box.

Editing Archive for random portal component section[edit]

For a random portal component section, the random pages are stored as consecutive numbered subpages from 1 to a maximum number. To view all numbered subpages in the archive page, use Template:Numbered subpages. Just write in the archive page {{Numbered subpages}}.

Randomized lists and elements in sections[edit]

See the random subpage template for a method to display a list of randomly selected items from a group of numbered subpages (e.g., Sustainable development). This template also can be used to randomly rotate items such as images within a section (e.g., the Philosophy of science introduction).

Changing colors[edit]

The colors of the portal can be changed in the box-header subpage. A list of colors you can use is available at Web colors, List of colors, or Wikipedia talk:Colours.

See also[edit]

Portals Featured (Criteria, Candidates) | List | Directory | WikiProject | Guidelines | Instructions | Categorizing | Peer review | Categories