Skeleton: Difference between revisions

From base48
imported>B42
m (project template image format update)
imported>B42
m (adjust headline level)
Line 9: Line 9:
}}
}}


= Project page =
== Project page ==
To mark a page as project, use the <nowiki>{{Project}}</nowiki> template. This will put your project into the projects category and it will render the Project info box on the right side of the content. The template has number of parameters described below.
To mark a page as project, use the <nowiki>{{Project}}</nowiki> template. This will put your project into the projects category and it will render the Project info box on the right side of the content. The template has number of parameters described below.


== Copy and Paste Template for Projects ==
=== Copy and Paste Template for Projects ===
'''NOTE: Please remove the optional fields you don't need from the list, otherwise it could have unwanted side effects on the layout.<br>
'''NOTE: Please remove the optional fields you don't need from the list, otherwise it could have unwanted side effects on the layout.<br>
Stars mark the fields that are mandatory.'''
Stars mark the fields that are mandatory.'''
Line 36: Line 36:
</pre>
</pre>


== Parameter Description ==
=== Parameter Description ===
=== name (mandatory) ===
==== name (mandatory) ====
Reflects the name of the project.
Reflects the name of the project.
This field has 2 functions:
This field has 2 functions:
Line 50: Line 50:
It is the name of the project page. Therefore the 'wikiPageName' field is not necessary.
It is the name of the project page. Therefore the 'wikiPageName' field is not necessary.


=== wikiPageName (optional) ===
==== wikiPageName (optional) ====
If this field is used, when the 'name' field will be only used as display name. Then the value of this field, will be used as project page name.
If this field is used, when the 'name' field will be only used as display name. Then the value of this field, will be used as project page name.


Line 60: Line 60:




=== image (optional) ===
==== image (optional) ====
This value should contain a File/Image wiki tag or a plain URL.
This value should contain a File/Image wiki tag or a plain URL.
Please ensure that the image is not bigger than 290px. '''NOTE:''' ''Bigger images will destroy the layout of the Project Page Meta field.''
Please ensure that the image is not bigger than 290px. '''NOTE:''' ''Bigger images will destroy the layout of the Project Page Meta field.''


=== founder (mandatory) ===
==== founder (mandatory) ====
This field should contain the list of founders or the founder himself.
This field should contain the list of founders or the founder himself.


Line 70: Line 70:
Example:<pre>|founder=name1,name2,name3</pre>
Example:<pre>|founder=name1,name2,name3</pre>


=== coops (optional) ===
==== coops (optional) ====
This field should contain the list of coops on the projects or a single coop.
This field should contain the list of coops on the projects or a single coop.


Line 76: Line 76:
Example:<pre>|coops=name1,name2,name3</pre>
Example:<pre>|coops=name1,name2,name3</pre>


=== swlic (optional) ===
==== swlic (optional) ====
If this value is used, it will display the value for the Software License fields.
If this value is used, it will display the value for the Software License fields.


=== hwlic (optional) ===
==== hwlic (optional) ====
If this value is used, it will display the value for the Hardware License fields.
If this value is used, it will display the value for the Hardware License fields.


=== status (mandatory) ===
==== status (mandatory) ====
The value of this field, will be displayed as the status of the project
The value of this field, will be displayed as the status of the project


=== tags (mandatory) ===
==== tags (mandatory) ====
This will help to automatically group the project in several lists we are displaying.
This will help to automatically group the project in several lists we are displaying.


Line 95: Line 95:
* infrastructure - Base 48 infrastructure related projects
* infrastructure - Base 48 infrastructure related projects


=== github (optional) ===
==== github (optional) ====
convenience function to put a link to a github repository in the project info box.
convenience function to put a link to a github repository in the project info box.


Line 102: Line 102:
It will be expanded to the full github url and displayed as link.
It will be expanded to the full github url and displayed as link.


=== shortdesc (mandatory) ===
==== shortdesc (mandatory) ====
It should contain a short description of the project. This value may contain multiple lines and formatting for the text. Like making something bold etc. Yes, lists can be used as well.
It should contain a short description of the project. This value may contain multiple lines and formatting for the text. Like making something bold etc. Yes, lists can be used as well.


Line 111: Line 111:
* Third point</pre>
* Third point</pre>


=== created (mandatory) ===
==== created (mandatory) ====
This field should be set to the date the project was started. The value should have the following format: YYYY-MM-DD
This field should be set to the date the project was started. The value should have the following format: YYYY-MM-DD


Example:<pre>|created=2012-03-16</pre>
Example:<pre>|created=2012-03-16</pre>


=== cur_version (optional) ===
==== cur_version (optional) ====
This field can be used to set the current version of the project. The value of this will be displayed as is in the 'Current Version' fields.
This field can be used to set the current version of the project. The value of this will be displayed as is in the 'Current Version' fields.


=== os (optional) ===
==== os (optional) ====
This field should be used to list the operating systems the project targets. The value of this will be displayed as is in the 'Operating System(s)' fields.
This field should be used to list the operating systems the project targets. The value of this will be displayed as is in the 'Operating System(s)' fields.


=== arch (optional) ===
==== arch (optional) ====
This field should be used to list the operating systems the project targets. The value of this will be displayed as is in the 'Architecture(s)' fields.
This field should be used to list the operating systems the project targets. The value of this will be displayed as is in the 'Architecture(s)' fields.


=== proglang (optional) ===
==== proglang (optional) ====
This field should be used to list the programming languages the project uses.  The value of this will be displayed as is in the 'Programming Language(s)' fields.
This field should be used to list the programming languages the project uses.  The value of this will be displayed as is in the 'Programming Language(s)' fields.


= Project creation and maintenance Help/Support =
== Project creation and maintenance Help/Support ==
<del>In case if you need anything from the perspective of creating a new project, or having some new meta information being added and displayed, please contact evilissimo for Help. :-)</del>
<del>In case if you need anything from the perspective of creating a new project, or having some new meta information being added and displayed, please contact evilissimo for Help. :-)</del>


Since the project template has been heavily tampered with, contact [[User:b42|b42]] if you need any help.
Since the project template has been heavily tampered with, contact [[User:b42|b42]] if you need any help.

Revision as of 21:12, 12 February 2013


Project page

To mark a page as project, use the {{Project}} template. This will put your project into the projects category and it will render the Project info box on the right side of the content. The template has number of parameters described below.

Copy and Paste Template for Projects

NOTE: Please remove the optional fields you don't need from the list, otherwise it could have unwanted side effects on the layout.
Stars mark the fields that are mandatory.

{{Project
 |name=*
 |wikiPageName=*
 |image=http://wiki.base48.cz/skins/base.png
 |founder=*
 |coops=
 |swlic=
 |hwlic=
 |status=*
 |tags=*
 |github=
 |shortdesc=*
 |created=*
 |curr_version=
 |os=
 |arch=
 |proglang=
}}

Parameter Description

name (mandatory)

Reflects the name of the project. This field has 2 functions:

  • Display Name
  • Page Name + Display Name

If you would like to show an other name in the meta information sections, than the name of the page, you can use this field to set a display name. In this case you will have to set the 'wikiPageName' field to the name of the page.

For this skeleton project page it looks like this:

|name=Skeleton

It is the name of the project page. Therefore the 'wikiPageName' field is not necessary.

wikiPageName (optional)

If this field is used, when the 'name' field will be only used as display name. Then the value of this field, will be used as project page name.

Example: If we would like to use the display name 'Other DisplayName example' instead of the name 'Skeleton', we would write it like this:

|name=Other DisplayName example
|wikiPageName=Skeleton


image (optional)

This value should contain a File/Image wiki tag or a plain URL. Please ensure that the image is not bigger than 290px. NOTE: Bigger images will destroy the layout of the Project Page Meta field.

founder (mandatory)

This field should contain the list of founders or the founder himself.

If there are multiple founders, then list them with the separator character ','

Example:

|founder=name1,name2,name3

coops (optional)

This field should contain the list of coops on the projects or a single coop.

If there are multiple coops, then list them with the separator character ','

Example:

|coops=name1,name2,name3

swlic (optional)

If this value is used, it will display the value for the Software License fields.

hwlic (optional)

If this value is used, it will display the value for the Hardware License fields.

status (mandatory)

The value of this field, will be displayed as the status of the project

tags (mandatory)

This will help to automatically group the project in several lists we are displaying.

Current known tags:

  • hw - Hardware project
  • sw - Software project
  • template - template page for common things (for example this project)
  • wiki - projects related to this wiki
  • infrastructure - Base 48 infrastructure related projects

github (optional)

convenience function to put a link to a github repository in the project info box.

Usage:

|github=user/repo

It will be expanded to the full github url and displayed as link.

shortdesc (mandatory)

It should contain a short description of the project. This value may contain multiple lines and formatting for the text. Like making something bold etc. Yes, lists can be used as well.

Example:

|shortdesc=This project's aim consists of the following points:
* First point
* Second point
* Third point

created (mandatory)

This field should be set to the date the project was started. The value should have the following format: YYYY-MM-DD

Example:

|created=2012-03-16

cur_version (optional)

This field can be used to set the current version of the project. The value of this will be displayed as is in the 'Current Version' fields.

os (optional)

This field should be used to list the operating systems the project targets. The value of this will be displayed as is in the 'Operating System(s)' fields.

arch (optional)

This field should be used to list the operating systems the project targets. The value of this will be displayed as is in the 'Architecture(s)' fields.

proglang (optional)

This field should be used to list the programming languages the project uses. The value of this will be displayed as is in the 'Programming Language(s)' fields.

Project creation and maintenance Help/Support

In case if you need anything from the perspective of creating a new project, or having some new meta information being added and displayed, please contact evilissimo for Help. :-)

Since the project template has been heavily tampered with, contact b42 if you need any help.