Saintapedia

Help:Portals

Wikipedia:Portal on Wikipedia
Shortcut:
H:P
Saintapedia namespaces[1]
Basic namespaces Talk namespaces
0 Main Talk 1
2 User User talk 3
4 Saintapedia Saintapedia talk 5
6 File File talk 7
8 MediaWiki MediaWiki talk 9
10 Template Template talk 11
12 Help Help talk 13
14 Category Category talk 15
100 Portal Portal talk 101
106 Form Form talk 107
420 GeoJson GeoJson talk 421
828 Module Module talk 829
844 CommentStreams CommentStreams talk 845
2300 Gadget Gadget talk 2301
2302 Gadget definition Gadget definition talk 2303
Virtual namespaces
-1 Special
view · talk · edit


Portals are essentially a page with a bunch of smaller pages contained in blocks which can easily be reorganized on a page. They utilize a responsive web design allowing content to be resized on different sized screen and mobile devices.

The idea of a portal is to help readers and/or editors navigate their way through Saintapedia topic areas through pages similar to the Main Page. In essence, portals are useful entry-points to Saintapedia content.

They intended to serve as "Main Pages" for specific topics or areas. It is meant for both readers and editors of Saintapedia, and should promote content and encourage contribution. A portal may be associated with one or more WikiProjects.


General suggestions

A portal helps to browse on a particular subject, hence the subject of a portal should be broad so that it presents a diversified content. The portal subject area should have enough interest and articles to sustain a portal, including enough quality content articles above a Start-class to sustain the featured content section. To aid in this, the portal should be associated with a WikiProject to help ensure a supply of new material for the portal. The portal layout should be complete or there should be ongoing efforts to make the portal layout complete. The portal should be maintained and serve a useful purpose.

Comparison to article format

Article format

  • Allows much more details to be presented
  • Allows for linking to section more easily
  • Are generally simpler to maintain
  • Very easy to setup

Portal format

  • Allows easy formatting of the page without tables
  • Ideal as Landing pages, either to serve as a gateway into additional content or with a strong call to action
  • Placement of multimedia content slightly more easier
  • Allows for rotating content
  • Better usability on mobile devices than tables
  • It is a more scan-able content format
  • Requires a bit more work to setup
  • Complexity is there, but mostly hidden

Strongly recommended items

  • Introduction – A short summary of the topic. If possible, this should contain an attractive image emblematic of the topic.
  • Categories – Links to the most important categories related to the topic.
  • Subportals or Related Portals (if there are any) – Some portals have these appear near the top, just below the "Introduction" (e.g. Arts or Technology). Others have them appear near the bottom (e.g., Biology or Literature). This section is not required if a topic-specific browsebar is used (e.g., Religion).
  • Topics – Links to the most important articles related to the topic.

Other items

  • Featured videos
  • Featured image
  • Featured biography/page
  • Featured facts - Did you know?

Subpages

It is recommended to put the {{Subpages}} template on the main Portal's talk page to easily find all of the subpages used by portals.

Block of content

 
Set of nine (9) portal blocks

Each portal is collection of block that are placed within various formatting components. Just like a child's building blocks, they can be rearranged easily by

  • moving them into different orders
  • moving them into different formatting components

Example block

Each block is made up of 3 lines of wikitext.

{{{{FULLPAGENAME}}/box-header|Section 1|{{FULLPAGENAME}}/Section 1|}}

{{{{FULLPAGENAME}}/Section 1}}

{{{{FULLPAGENAME}}/box-footer|}}

Formatting components

 
Screenshot of portal with annotations

There are a number of formatting components, also known as layout options or section types, in which blocks can be placed. Many layout options which work best in pairs.

Introduction section

The Introduction is:

  • Width - Full width (100% of the screen)
  • Number of sections - It is recommended to only use one per portal
  • Other comments

Example - Introduction

 

Wikitext block - Introduction

<!-- This is the portal's introduction. It spans two columns By default. Currently it displays the portal's name in the title box. You can rename by replacing {{PAGENAME}} with the name you desire (remove the {{ }}). You can also remove this section altogether if it's not needed. -->

<div style="clear:both; width:100%">

{{{{FULLPAGENAME}}/box-header|<big>{{PAGENAME}}</big>|{{FULLPAGENAME}}/Intro|}}

{{{{FULLPAGENAME}}/Intro}}

{{{{FULLPAGENAME}}/box-footer|}}

Two equal columns

The Two equal columns

  • Width -
    • "portal-column-left" (50%)
    • "portal-column-right" (50%)
  • Number of sections -
    • Unlimited blocks
    • By default:
      • 2 left blocks
        • Section 1
        • Section 2
      • 2 right blocks
        • Section 20
        • Section 21
  • Other comments
    • Numbering is set to allow:
      • 8 more left (Section 3-10)
      • 8 more right (Section 22-29)
    • Sections 11-19 are unused for now

Example - Two columns

 

Wikitext block - Two columns

  • There are two columns (right and left)
  • By default, each column comes with two blocks in each column
Left column
Header

<!-- Box sections below portal-column-left will be placed on the left, with a width of 50%. Add as many as desired. -->

<div class="portal-column-left">

Left block one

<!-- Replace "Section x" with your desired section name. For example: Links, or documents -->

{{{{FULLPAGENAME}}/box-header|Section 1|{{FULLPAGENAME}}/Section 1|}}

{{{{FULLPAGENAME}}/Section 1}}

{{{{FULLPAGENAME}}/box-footer|}}

Left block two

{{{{FULLPAGENAME}}/box-header|Section 2|{{FULLPAGENAME}}/Section 2|}}

{{{{FULLPAGENAME}}/Section 2}}

{{{{FULLPAGENAME}}/box-footer|}}

End - left

</div>

Right column
Header - right

<!-- Box sections below portal-column-right will be placed on the right, with a width of 49%. Add as many as desired. -->

<div class="portal-column-right">

<!-- Replace "Section x" with your desired section name. For example: Links, or documents -->

1st right block

{{{{FULLPAGENAME}}/box-header|Section 20|{{FULLPAGENAME}}/Section 20|}}

{{{{FULLPAGENAME}}/Section 20}}

{{{{FULLPAGENAME}}/box-footer|}}

2nd right block

{{{{FULLPAGENAME}}/box-header|Section 21|{{FULLPAGENAME}}/Section 21|}}

{{{{FULLPAGENAME}}/Section 21}}

{{{{FULLPAGENAME}}/box-footer|}}

End - right

</div>

Full width

The Full width component

  • Width - full width (100%) of the page
  • Number of sections -
    • Unlimited blocks
    • By default - one block
  • Comments
    • It is referred to as "Two-Column Section"
    • The initial block is "Two-Column Section 30"
      • Numbering is set to allow:
        • 8 more (Two-Column Section 31-28)

Example - Full width

 

Wikitext block - Full width

<!-- Box sections below this div will span two columns. Add as many as desired. -->

<div style="clear:both; width:100%">

{{{{FULLPAGENAME}}/box-header|Two-Column Section 30|{{FULLPAGENAME}}/Two-Column Section 30|}}

{{{{FULLPAGENAME}}/Two-Column Section 30}}

{{{{FULLPAGENAME}}/box-footer|}}

</div>

Wide and narrow sections

The Wide and narrow sections

  • Width -
    • "portal-column-left-wide" (60%)
    • "portal-column-right-narrow" (39%)
  • Number of sections -
    • Unlimited blocks
    • By default:
      • 1 wide block
        • Wide Section 40
      • 1 narrow block
        • Narrow Section 45
  • Other comments
    • Numbering is set to allow:
      • more wide blocks (Wide Section 41-44)
      • more narrow blocks (Narrow Section 46-19)

Example - Wide and narrow

 

Wikitext block - Wide and narrow

Left wide

<!-- Box sections below portal-column-left-wide will be wider and placed on the left, with a width of 60%. Add as many as desired. You also change placement to Right-->

<div class="portal-column-left-wide">

<!-- Replace "Section x" with your desired section name. For example: Links, or documents -->

{{{{FULLPAGENAME}}/box-header|Wide Section 40|{{FULLPAGENAME}}/Wide Section 40|}}

{{{{FULLPAGENAME}}/Wide Section 40}}

{{{{FULLPAGENAME}}/box-footer|}}

</div>

Right narrow

<!-- Box sections below portal-column-right-narrow will be narrower and placed on the right, with a width of 39%. Add as many as desired. You also change placement to left -->

<div class="portal-column-right-narrow">

<!-- Replace "Section x" with your desired section name. For example: Links, or documents -->

{{{{FULLPAGENAME}}/box-header|Narrow Section 45|{{FULLPAGENAME}}/Narrow Section 45|}}

{{{{FULLPAGENAME}}/Narrow Section 45}}

{{{{FULLPAGENAME}}/box-footer|}}

</div>

Extra wide and extra narrow sections

The Wide and narrow sections

  • Width -
    • "portal-column-left-extra-wide" (70%)
    • "portal-column-right-extra-narrow" (29%)
  • Number of sections -
    • Unlimited blocks
    • By default:
      • 1 Extra Wide
        • Extra Wide Section 50
      • 1 Extra Narrow block
        • Extra Narrow Section 55
  • Other comments
    • Numbering is set to allow:
      • more extra wide blocks (Wide Section 51-54)
      • more extra narrow blocks (Narrow Section 56-59)

Example - Extra wide and narrow

 

Wikitext block - Extra wide and narrow

Extra vide left

<!-- Box sections below portal-column-left-extra-wide will be extra wide and placed on the left, with a width of 70%. Add as many as desired. You also change placement to Right-->

<div class="portal-column-left-extra-wide">

<!-- Replace "Section x" with your desired section name. For example: Links, or documents -->

{{{{FULLPAGENAME}}/box-header|Extra Wide Section 50|{{FULLPAGENAME}}/Extra Wide Section 50|}}

{{{{FULLPAGENAME}}/Extra Wide Section 50}}

{{{{FULLPAGENAME}}/box-footer|}}

</div>

Extra narrow right

<!-- Box sections below portal-column-right-extra-narrow will be extra narrow and placed on the right, with a width of 29%. Add as many as desired. You also change placement to Left-->

<div class="portal-column-right-extra-narrow">

<!-- Replace "Section x" with your desired section name. For example: Links, or documents -->

{{{{FULLPAGENAME}}/box-header|Extra Narrow Section 55|{{FULLPAGENAME}}/Extra Narrow Section 55|}}

{{{{FULLPAGENAME}}/Extra Narrow Section 55}}

{{{{FULLPAGENAME}}/box-footer|}}

</div>

Creating a portal

Manually

File:Portal creation.mp4

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

Create base portal

Create a new page using [[Portal:Topic]] as the title of the page (where "Topic" is the subject of your portal).

  • Enter the following text
{{subst:box portal skeleton}}

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

Create subpage

Create two subpages, scroll to the bottom of the page and click the template link to the header and footer

Box-header

Create [[Portal:Topic/box-header]] with by copying and adding the text below. 

{{subst:Portal:Box-header}} 
|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}}<noinclude>       <!-- This is the color of the Box Section text -->
</noinclude>

See lots of Wikipedia box headers.

Box-footer

Create [[Portal:Topic/box-footer]] by copying and adding the text below. 

{{subst:Portal:box-footer}}

Begin editing

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.

Additional requested steps

1. 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}}.

2. List your new portal in the Directory of portals.

3. 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.

4. Edit the portal text. (See Customisation and editing below for instructions.)

5. When the portal is complete and of good quality:

6. Create a redirect from the name of your portal to the portal page. This will ensure those trying to find it or link to it can do so without a problem.

Customizing

Renaming section labels on portals

By default, the labels match the subpage name. See below for an example.

{{{{FULLPAGENAME}}/box-header|Section 1|{{FULLPAGENAME}}/Section 1|}}

To customize them, simply change the name after the pipe (|), leaving the name after the forward slash (/) alone.

{{{{FULLPAGENAME}}/box-header|Contact Us|{{FULLPAGENAME}}/Section 1|}}

Adding a section

 
Breakdown of wikitext (Edit source)

To add a section, copy the text of the type of section you wish to add. Below is an example.

{{{{FULLPAGENAME}}/box-header|Section 1|{{FULLPAGENAME}}/Section 1|}}
{{{{FULLPAGENAME}}/Section 1}}
{{{{FULLPAGENAME}}/box-footer|}}

Below the "Section 1" have been replaced with "Section 3."

{{{{FULLPAGENAME}}/box-header|Section 3|{{FULLPAGENAME}}/Section 3|}}
{{{{FULLPAGENAME}}/Section 3}}
{{{{FULLPAGENAME}}/box-footer|}}

Copy it within the div borders.

<div class="portal-column-left">

<!-- Replace "Section x" with your desired section name. For example: Links, or documents  -->

{{{{FULLPAGENAME}}/box-header|Section 1|{{FULLPAGENAME}}/Section 1|}} 

{{{{FULLPAGENAME}}/Section 1}}

{{{{FULLPAGENAME}}/box-footer|}}

{{{{FULLPAGENAME}}/box-header|Section 2|{{FULLPAGENAME}}/Section 2|}}  

{{{{FULLPAGENAME}}/Section 2}}

{{{{FULLPAGENAME}}/box-footer|}}

{{{{FULLPAGENAME}}/box-header|Section 3|{{FULLPAGENAME}}/Section 3|}}  

{{{{FULLPAGENAME}}/Section 3}}

{{{{FULLPAGENAME}}/box-footer|}}

</div>

Color

 
Portal color options

The colors of the portal can be adjusted in the box-header subpage.

Copying a portal's formatting

  1. Follow a red link
  2. Select the boilerplate template called “Template:Box portal skeleton” from the drop down list
  3. Click load
  4. Add edit summary such as “start portal”
  5. Save the page
  6. Click on the red link with “Box-header” and copy the Box-header page from the portal you are copying to add formatting. You could also you the default formatting from the grey box.
  7. Save the page
  8. Click on the red link with “Box-header” and paste in “{{Portal:box-footer | {{{1}}} }}<noinclude></noinclude>” in the content box
  9. Save the page
  10. Customize

Tabs

File:Saintapedia tabs.png
Example tabs

Tabs can add more places for information, while keeping most content above the fold.

It is recommended to:

1. Create a subpage

Example - Portal:Demo/Tabs

2. Add the Start tab template there

  • The first tab should have two field in the form
    • link-1 - The page where it should
    • tab-1 - The text
  • Other customization
    • frame - Set to yes to add a page frame underneath the tabs
    • frame color - Background color for frame
    • off tab color - Color of the currently unselected tabs
    • on tab color - Color of the currently selected tab
    • rounding - Add rounding effect to edges of tab boxes

The maximum number of available tabs is 20.

3. Add it to to the portal landing pages at the top using edit source

  • On the main portal landing, this can be done with {{/Tabs}}
  • On others, you could point it to the page, such as {{Portal:Demo/Tabs}}

Rotating content

It is recommended creating a subpage to help organize the rotating content.

Example - Portal:Demo/Videos

Template:Rotate portal pages

How to add portal links to articles

File:Portal-puzzle.png Community portal
File:Portal-puzzle.png Headquarters portal

Within articles, the {{Portal}} template is meant to be placed at the bottom of the article in the See also section. If there is no See also/Related section, you can put it in the External links section instead; there is no need to create a new section just to house this template. If there is no External links section either, just put it below the article text in the place that seems most appropriate. There are no particular rules about the placement of portals on other kinds of page.

Entering the link at the top of the section will allow it to sit on the top right. Add a portal link by typing {{Portal|<portal name>}} for example {{Portal|Community}}. If more than one portal is to be linked use a second parameter, for example {{Portal|Community|Headquartersg}} (illustrated on right).

If there are problems with the regular {{Portal}} causing undesired layout effects use {{Clear}}

{{Portal bar}} (example shown below)Lua error in package.lua at line 80: module 'Module:Portal' not found.

  • {{Portal-inline}} or
  • an icon-free text link * [[Portal:Energy|Energy portal]],
Community portal

Historic

Tabs alternative

This is a previous recommended version is no longer recommended.

Text needed

{{Portal:PORTAL NAME/TabsTop}}

{{Portal:PORTAL NAME/Tab1|#EE9A49|black}}

{{Portal:PORTAL NAME/Tab2}}

{{Portal:PORTAL NAME/Tab3}}

{{Portal:PORTAL NAME/TabsBottom}}<noinclude>

{{-}}

==Usage==

To create a set of tabs, use these elements. Keep the page tabs in the same order.

* "Current" page paramenters: #EE9A49 black

* "Other" page paramenters: #CD3700 white (default)

{{[[Portal:PORTAL NAME/TabsTop]]}}<br>

{{[[Portal:PORTAL NAME/Tab1]]|background|text color}}<br>

{{[[Portal:PORTAL NAME/Tab2]]|background|text color}}<br>

{{[[Portal:PORTAL NAME/Tab3]]|background|text color}}<br>

{{[[Portal:PORTAL NAME/TabsBottom]]}}

The three portal pages that display these tabs are -

:Portal:PORTAL NAME using [[Portal:PORTAL NAME/Tabs]]

:Portal:PORTAL NAME/(second tab) using [[Portal:PORTAL NAME/Topics/Tabs]]

:Portal:PORTAL NAME/(third tab) using [[Portal:PORTAL NAME/Things you can do/Tabs]]

</noinclude>

Examples

Renaming

To rename a tab:

  1. Follow to tab link
  2. Rename the page as normal (keeping it in the Portal namespace)
  3. Go to the tab subpage (such as Portal:Occupational medicine/Tab2)
  4. Change the link and the tab title
  5. Save the page changes

Featured portal criteria

Wikipedia' Featured portal criteria , listed below is a good measuring stick to use as we start to create portals.

  1. It is:
    • (a) Useful. It covers a topic that is sufficiently broad and prominent to justify it as an entry point. Because portals promote the best of Wikipedia's content, a featured portal is selective in what it displays. It showcases only high-quality content that is preferably already featured.
    • (b) Attractive. It displays Wikipedia's content in an aesthetically pleasing way. The colours are coherent and complementary, and do not detract from the content. Featured portals have no formatting issues. Red links are limited in number and restricted to aspects that encourage contribution. Article and biography summaries should not significantly exceed 200 words in length.
    • (c) Ergonomic. It is coherently constructed to display Wikipedia's content logically and effectively in ways that enhance usefulness and attractiveness. This display is the primary aim; encouraging contribution is secondary.
    • (d) Well-maintained. It is updated regularly to display different aspects of Wikipedia's content in an area. Featured portals may be designed to reduce the required frequency of updating; however, they may be designed to have a higher turnover of content, using structures to ensure regular updates (e.g., WikiProjects). Featured portals that require maintenance and are not updated for three or more months are summarily demoted.
  2. It adheres to the standards in the Manual of Style and the relevant WikiProject guidelines; this includes conventions on naming, spelling, and style (see Portal and Portal guidelines).
  3. It has images where appropriate, with concise captions, linked credits, and acceptable copyright status (see Wikipedia:Non-free content).
  4. It is not self-referential: it does not speak of itself beyond (if at all) a welcome note. Aspects of portals that encourage contribution may be self-referential.

Related

External links

Featured Wikipedia portals

Purge

  1. ↑ https://www.mediawiki.org/wiki/Extension_default_namespaces
Retrieved from ‘https://saintapedia.org/w/index.php?title=Help:Portals&oldid=6157’