Template:Project-summary: Difference between revisions

From OLPC
Jump to navigation Jump to search
mNo edit summary
(notes on where used and how may be obsolete; new Category:Activity microformat templates)
 
(63 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<noinclude>Template for [[Activity Grid]]; one row in a table. Comments for html alignment.
<noinclude>Template for [[Activities]] and [[Collections]]; one row in a table. Should be made more general to cover all projects (taking a type='activity' or 'collection' or 'other' argument perhaps). Comments added for html alignment.

This template (and a redirect to it, {{tl|Activity-summary}}) is used on the [[Collections]] page. It is also in a bunch of fragmentary subpages under Projects/ such as [[Projects/Write]] ''that seem to be out-of-date and may all be obsolete.''

<br clear="all">
<br clear="all">

{| border=1
{| border=0 cellspacing="1" cellpadding="5" style="background:#ccc;"

</noinclude>
</noinclude>
|- valign="top"
|- valign="top" bgcolor="#F9F9Fc" class="olpc-activity-info"
|width="5%" name="icon" bgcolor="white"| [[Image:activity-{{{simplename}}}.svg|40px| {{{simplename}}} icon]]
| width="5%" id="icon" name="icon" bgcolor="white" | [[Image:{{#if:{{{image|}}}|{{{image}}}|activity-{{{simplename|none}}}.svg}}|40px| icon for {{{simplename}}}]]
|width="65%" name="description, authors, static metadata"| [[Category:activity summary]]<span class="plainlinks"><!--
| width="65%" name="description, authors, static metadata"| [[Category:activity summary]]<span class="plainlinks"><!--
--> <big>[[{{{prettyname}}}]]</big> : {{{description}}} <br/>''{{{comments}}}&nbsp;'' [http://wiki.laptop.org/index.php?title=Activities/{{{prettyname}}}&action=edit +/-]<br/><small><!--
--> <span class="olpc-activity-id" style="display:none;">{{{bundle_id|}}}</span><big> [[{{{prettyname|unknown}}}]]</big> : {{{description|''none''}}} [[Projects/{{{prettyname|none}}}|<sup><small>edit</small></sup>]] <br /> <!--
--> {{{comments|''no comments''}}}&nbsp; <br/><small><!--
--> '''[[Maintainers|<font color="#006600">Maintainers</font>]]''': {{{maintainers}}} &nbsp;&middot;&nbsp; <!--
--> '''[[Licenses|<font color="#006600">License</font>]]''': {{{license}}} &nbsp;&middot;&nbsp; <!--
--> '''[[Maintainers|<font color="#006600">Maintainers</font>]]''': {{{maintainers|?}}} &nbsp;&middot;&nbsp; <!--
--> '''[http://www.iana.org/assignments/media-types <font color="#006600">Mime types</font>]''': {{{mimetypes}}}</small></span><!--
--> '''[[Licenses|<font color="#006600">License</font>]]''': {{{license|''unspecified''}}} &nbsp;&middot;&nbsp; <!--
--> '''[http://www.iana.org/assignments/media-types <font color="#006600">Mime types</font>]''': {{{mimetypes|?}}}</small></span><!--
-->
-->
|width="30%" name="versions, builds, locales"| <span class="plainlinks"><!--
| width="30%" name="versions, builds, locales"| <span class="plainlinks"><!--
--> '''{{#if:{{{download-url|}}}
--> <tt>'''Download''' :</tt> '''[[:Image:{{{packagename}}}-{{{version}}}.xo| {{{packagename}}}-{{{version}}}.xo]]''' &middot; <small>[{{{source-url}}} source ]</small><!--
| <span class="olpc-activity-url"> [{{{download-url}}} <tt>download</tt> v.<span class="olpc-activity-version">{{{version|?}}}</span>]</span>
--> <br/><tt>'''Builds &nbsp;''':</tt> {{{builds}}} <small>([[Tests/{{{prettyname}}}|tests]] &middot; [https://dev.laptop.org/query?component={{{simplename}}}-activity&order=priority tickets])</small><!--
| <span class="olpc-activity-url"> [[:Media:{{{packagename|unknown}}}-{{{version|}}}.{{{bundle-extension|xo}}}|<tt>Download</tt> v.<span class="olpc-activity-version">{{{version|?}}}]]</span> </span> <!--
--> <br/><tt>'''[[Localization|<font color="#006600">Translate</font>]]''':</tt> {{{l10n-link}}} <!--
--> <br/><small>''{{{l10n-notes}}}&nbsp;''</small><noinclude>
--> }}''' &middot; <small>{{#if:{{{source-url|}}}|[{{{source-url}}} source] |}}</small><!--
--> <br/><tt>'''[[Tests/{{{prettyname|}}}|<font color="#006600">Tested</font>]] in''':</tt> {{{builds|''no builds''}}} <small>([https://dev.laptop.org/query?component={{{simplename}}}-activity&order=priority trac])</small><!--
|}
--> <br/><tt>'''[[Localization|<font color="#006600">Translate</font>]]''':</tt> {{{l10n-link|?}}}<!--
--> &middot; &nbsp; <small>''{{{l10n-notes|}}}&nbsp;''</small></span><noinclude>
|}
<br clear="all">
<br clear="all">




== Usage ==
== Usage ==
Icons should be uploaded as svg's (just as in the bundles) named <tt>activity-<name>.svg</tt>. New versions of the bundles should be uploaded as <tt><name>-<versionnumber>.xo</tt>. <tt>packagename</tt> is a version of ''simplename'' used in filenames and in software class names for readability. ''(This is for historical reasons. simplename and packagename should be merged across activities in our style guide, so that there are only two variations on a name aside from the unique service_name. [[User:Sj|Sj]]&nbsp;[[User talk:Sj|<font color="fc9"><small>talk</small></font>]])''
Activity icons should be uploaded as svg's (just as in the bundles) named <tt>activity-<name>.svg</tt>. New versions of the bundles should be uploaded as <tt><name>-<versionnumber>.xo</tt>. <tt>packagename</tt> is a version of ''simplename'' used in filenames and in software class names for readability. ''(This is for historical reasons. simplename and packagename should be merged across activities in our style guide, so that there are only two variations on a name aside from the unique service_name. [[User:Sj|Sj]]&nbsp;[[User talk:Sj|<font color="fc9"><small>talk</small></font>]])''


{{new activity key}}
{{project key}}



=== Samples ===
See e.g. [[Projects/Browse]], [[Projects/Write]]

This generates HTML using the [[Activity microformat]] CSS identifiers.
''However,'' note that the [[activity group]] pages pull in the similar but simpler [[Activities/Browse]] and [[Activities/Write]] pages that use {{tl|Activity-oneline}}.

You may have to surround these with table code , e.g.
<pre><nowiki>
{| class="wikitable sortable" style="background:#F9F9F9 none repeat scroll 0%; border:1px solid #AAAAAA; border-collapse:collapse; margin:1em 1em 1em 0pt;" border="1" cellpadding="3" cellspacing="0"
{| class="wikitable sortable" style="background:#F9F9F9 none repeat scroll 0%; border:1px solid #AAAAAA; border-collapse:collapse; margin:1em 1em 1em 0pt;" border="1" cellpadding="3" cellspacing="0"
{{:Activities/Browse}}
{{:Activities/Browse}}
{{:Activities/Write}}
{{:Activities/Write}}
{{:Projects/Tux Paint}}
|}
|}


</nowiki></pre>
[[Category:Template]]</noinclude>

[[Category:Activity microformat templates]]</noinclude>

Latest revision as of 03:15, 11 January 2009

Template for Activities and Collections; one row in a table. Should be made more general to cover all projects (taking a type='activity' or 'collection' or 'other' argument perhaps). Comments added for html alignment.

This template (and a redirect to it, {{Activity-summary}}) is used on the Collections page. It is also in a bunch of fragmentary subpages under Projects/ such as Projects/Write that seem to be out-of-date and may all be obsolete.


icon for {{{simplename}}} unknown : none edit
no comments 
Maintainers: ?  ·  License: unspecified  ·  Mime types: ?
Download v.? ·
Tested in: no builds (trac)
Translate: ? ·    



Usage

Activity icons should be uploaded as svg's (just as in the bundles) named activity-<name>.svg. New versions of the bundles should be uploaded as <name>-<versionnumber>.xo. packagename is a version of simplename used in filenames and in software class names for readability. (This is for historical reasons. simplename and packagename should be merged across activities in our style guide, so that there are only two variations on a name aside from the unique service_name. Sj talk)

Key:

New activities should use the project-pre-summary template, including:

prettyname - the display name for the activity, such as Comic Maker. 
description - a few sentences describing the activity and its audience
categories - any keywords that match your activity and its use.  
   see the activities grid for examples.
maintainers - people actively working on the activity, with links to 
   their userpages or ways to contact them.
image - title of an uploaded image that may make a suitable icon
port-notes - notes on other platforms and potential or in-progress ports
mimetypes - mime types that the activity can read and launch.
comments - general comments about development.
l10n-notes - comments about localization, including links for translating
   existing related projects.
license - the name of the license[s] your activity uses, with a link
   to its full text.
status - from 0 to 6.  0:idea, 1:stub, 2:immature, 3:active development,
   4:beta, 5:stable, 6:finishing touches

Testable projects should review the style guide and use the project-summary template, also including:

simplename - a simple name for the activity: it should contain only lowercase 
   letters, numbers, hyphens, underscores.  Determines the name of some source files.
packagename - the name used for project bundles; it should not contain spaces.
   It can be the same as simplename (best option) or a CamelCase version of it 
   (some existing activities do this). 
license - the name of the license[s] your activity uses, with a link
   to its full text.
status - from 0 to 6.  0:idea, 1:stub, 2:immature, 3:active development,
   4:beta, 5:stable, 6:finishing touches
version - the version number of the latest build.
source-url - a raw url for the source repository .
builds - latest builds in which the activity has been tested.
l10n-url - url and title of a place to go to translate the activity.
   common options are {{pootle|xo_core}} and {{pootle|xo_bundled}}.


Samples

See e.g. Projects/Browse, Projects/Write

This generates HTML using the Activity microformat CSS identifiers. However, note that the activity group pages pull in the similar but simpler Activities/Browse and Activities/Write pages that use {{Activity-oneline}}.

You may have to surround these with table code , e.g.

{| class="wikitable sortable" style="background:#F9F9F9 none repeat scroll 0%; border:1px solid #AAAAAA; border-collapse:collapse; margin:1em 1em 1em 0pt;" border="1" cellpadding="3" cellspacing="0"
{{:Activities/Browse}}
{{:Activities/Write}}
{{:Projects/Tux Paint}}
|}