Help:Portals: Difference between revisions

{{Breadcrumbs|page=Wikipedia:Portal|url=|wikipedia=yes|openei=no|imwiki=no}}{{Shortcut|H:P}}{{Namespaces}}

{{Comment|{{#lst:Help:Portal|intro}}}}

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

====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 [[Web usability|usability]] on mobile devices than [[Help:Table|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?

*moving them into different orders

*moving them into different formatting components

*[[Help:Portal#Introduction%20section|Introduction section]] - Component A

*[[Help:Portal#Two%20equal%20columns|Two equal columns]] (pair recommended) - Component B

*[[Help:Portal#Full%20width|Full width]] - Component C

*[[Help:Portal#Wide and narrow sections|Wide and narrow sections]] (pair recommended) - Component D

*[[Help:Portal#Extra wide and extra narrow sections|Extra wide and extra narrow sections]] (pair recommended) - Component E

*Width - Full width (100% of the screen)

*Number of sections - It is recommended to only use one per portal

*Other comments

**Similar to [[Help:Portal#Full%20width|Full width]]

===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====

[[File:Portal - Two columns.png|none|thumb|600x600px]]

===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====

[[File:Portals - Full width.png|600x600px]]

====Wikitext block - Full width====

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

===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)

===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)

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

  <nowiki>{{subst:box portal skeleton}}</nowiki>

====Box-header====

  &#0124;editpage={{{2}}}  

  &#0124;border=#aaaaaa          <nowiki><!-- This is the color of the borders around Box Sections --></nowiki>

  &#0124;titleforeground=white    <nowiki><!-- This is the color of the Box Section Title Bar text --></nowiki>

  &#0124;titlebackground=#aaccff  <nowiki><!-- This is the color of the Box Section Title Bar --></nowiki>

  &#0124;background=#f9f9ff      <nowiki><!-- This is the color of the Box Section background --></nowiki>

  &#0124;<nowiki>foreground=black}}</nowiki><nowiki><noinclude>      <!-- This is the color of the Box Section text --></nowiki>

  <nowiki></noinclude></nowiki>

====Box-footer====

===Begin editing===

===Color===

[[File:Portal color options.png|thumb|485x485px|Portal color options]]The colors of the portal can be adjusted in the box-header [[subpage]].

*Replace "Topic" with your portal's name - "Portal:Topic/box-header"

**[https://venngage.com/tools/accessible-color-palette-generator Accessible color palette generator]

*Wikipedia has [https://en.wikipedia.org/wiki/Template:Box-header#Box-header_color_palettes Box-header color palettes], but they have not been vetted for accessibility

*[http://www.color-hex.com/color-names.html HEX Colors] can be useful

===Copying a portal's formatting===

#Follow a red link

#Select the boilerplate template called “Template:Box portal skeleton” from the drop down list

#Click load

#Add edit summary such as “start portal”

#Save the page

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

#Save the page

#Click on the red link with “Box-header” and paste in “<nowiki>{{Portal:box-footer | {{{1}}} }}<noinclude></noinclude></nowiki>” in the content box

#Save the page

#Customize

===Tabs===

It is recommended to:

*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

*On the main portal landing, this can be done with <code><nowiki>{{/Tabs}}</nowiki></code>

*On others, you could point it to the page, such as <code><nowiki>{{Portal:Demo/Tabs}}</nowiki></code>

*{{tl|Portal-inline}}  or

*an icon-free text link ''<nowiki>* [[Portal:Energy|Energy portal]]</nowiki>'',

====Examples====

*{{W|Portal:Human rights/Things you can do/Tabs}}

*{{W|Portal:African American/Tabs}}

====Renaming====

To rename a tab:

#Follow to tab link

#[[Rename a page|Rename the page]] as normal (keeping it in the Portal [[namespace]])

#Go to the tab subpage (such as [[Portal:Occupational medicine/Tab2]])

#Change the link and the tab title

#Save the page changes

==Featured portal criteria==

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

#It is:</noinclude>

#*(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 be determined-->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.

#It adheres to the standards in the [[Wikipedia:Manual of Style|Manual of Style]] and the relevant [[Wikipedia:WikiProjects|WikiProject]] guidelines; this includes conventions on naming, spelling, and style (see [[Wikipedia:Portal|Portal]] and [[Wikipedia:Portal/Guidelines|Portal guidelines]]).

#It has [[Wikipedia:Images|images]] where appropriate, with [[Wikipedia:Captions|concise captions]], linked credits, and acceptable [[wikipedia:Copyrights|copyright status]] (see [[Wikipedia:Non-free content]]).

#It is not [[Wikipedia:Avoid self-references|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==

*This [[template]] is used to produce a link in a box to a portal or portals.

*[[Portal:Portal directory]]

===Featured Wikipedia portals===

*{{W|Portal:War}} - Categories included

*{{W|Portal:American Civil War}} - WikiProject tasks included

*{{W|Portal:Italian Wars}} - Major topics

*{{W|Portal:World War II}} - Colored

*{{W|Portal:Energy}} - /TabBar

*{{W|Renewable energy}} - /TabBar

*{{W|Portal:Medicine}} - {{W|Template:WikiProject Medicine tabs}}

*{{W|Portal:Nevada}}

*{{W|Portal:New York City}}

{{Purge}}