http://www.framasoft.org

ARTICLE: FORMS FORMATTING UPDATING TRANSLATING WRITING PLEASE DO NOT: ...

A brief reminder concerning writing, updating, translating and formatting the articles.

(version 1.1)

By the Website team

Framasoft

« Discovering the World of Open Source for Windows... »

http://www.framasoft.org/

HOW TO COMPLETE THE FORMS	(French original page: L’ajout de notices )

Champ	Description	Remarks
Top title	Link to the official Website	REQUIRED
Title	Name of the software	REQUIRED
Subtitle	Link to a screenshot (if available)	REQUIRED (if available)
In section	Place for the “article” (Text & Office, Internet, Tutorials,...)	REQUIRED
Brief description	A (brief) description of the software	REQUIRED
Hypertext link (Title, URL)	Generally empty (do not write inside!)
Deck	Place for Keywords (OS, language, size,...)	REQUIRED
Text	Place for the detailed presentation (or article)	REQUIRED
Postscript	Links related to the software: Tutorials Forum Manuals ...	RECOMMENDED (if available)

FORMATTING	(French original page: Mise en forme d’une notice )

Object	Action	Result
BOLT	Place between {{ and }} => {{This is bold}}	This is bold
ITALIC	Place between { and } => {This is in italics}	This is in italics
LISTS	Use “ - ” + “ * ” => “ -* ” -* He is handsome -* He is tall -* He is nice	He is handsome He is tall He is nice
QUOTATIONS	<quote> « Il était jeune, il était beau, il sentait bon le sable chaud. » _ Edith Piaf </quote>	« Il était jeune, il était beau,il sentait bon le sable chaud. » _ Edith Piaf
FOOTNOTES	Place between [[ and ]] => « Goodbye [[And thanks!]] »	« Goodbye [3] » (“And Thanks” (3) is located at the end of the document, among the other footnotes)
INTERNAL LINKS	Place the word or sentence between [ and ] => Article: [OpenOffice.org->art472] Section: [OpenOffice.org->rub90]	Link to the article: OpenOffice.org Link to the section: OpenOffice.org
EXTERNAL LINKS (especially in the Postscript)	- Place the word, the sentence between [ and ] - “word” + “->” + “link” (pasted together) => [OpenOffice.org->http://www.openoffice.org/]	Official Website OpenOffice.org
WIKIPEDIA (http://en.wikipedia.org/wiki/Main_Page) (Open-content encyclopedia We strongly recommend its use)	Place the word or sentence, preceded by ?, between [ and ] Nous parlons d’[?Internet].... Dans un [?site web], il faut.... Le protocole de transmission du Net est le [?TCP]/[?IP]	=> Nous parlons d’Internet => Dans un site Web, il faut... => Le protocole de transmission du Net est le TCP/IP

UPDATING	(French original page: La mise à jour des notices )

1- WHAT? -> Links (internal, external, missing screenshots, WIKIPEDIA,...)

-> Updates from the actual article

-> Additions to the original article

-> ...

2- HOW? -> 1) Choose the software (either from the public or the private interface)

2) Change into complete interface (SPIP internal menu)

3) Scroll down to ARTICLE LANGUAGE AND TRANSLATIONS (français)

4) Click on the black triangle (►)

5) Click on“Write a new translation of this article"

6) Writy the article as usual while modifying / adding / transforming the new points

7) Save the new article in “99. Espace des mises à jour (français) “

For presentation, see “FORMATTING” AND “HOW TO COMPLETE THE FORMS” (see above)

TRANSLATING THE ARTICLES	(French original page: La traduction des notices )

1) WHAT? -> The software description that you wish to work on

-> The “Tribune Libre” which interests you

-> The tutorial that you prefer

-> ...

2) HOW? ->	1) Choose the software (either from the public or the private interface)

2) Change into complete interface (SPIP internal menu) / Se mettre dans Interface complète (menu interne de SPIP)

3) Change the language interface (if possible)

4) Scroll down to LANGUE ET TRADUCTIONS DE L’ARTICLE (français)

5) Click on the black triangle (►)

6) Click on Write a new translation of this article"

7) Save the new article in correct section (In the section)

WRITING / FINAL POINTS

Writing of software review:

Verify that: - it does not already exist

- the software is really an open source programme

- the review is in the correct section (Text & Office, Graphics, Tutorials,...)

- you have made all the Wikipedia links (no duplications)

- you have made all the internal links

- spelling and punctuation

Paragraph:	- At least TWO paragraphs must be written (homogenization of the site)

- Be careful with the spelling and punctuation

- Be careful with the writing style

Spelling and punctuation	- The open-content encyclopedia Wikipedia (http://en.wikipedia.org/wiki/Main_Page)

- The Merriam-Webster online dictionary (http://www.m-w.com/)

- The punctuation rules (http://www.kimskorner4teachertalk.com/writing/conventions/punctuation.html)

After asking for publication (Submitted for evaluation), do not forget to check regularly for any attached commentary (at the bottom of the article), and to take these into account (if necessary) in order to improve your work..

We are expecting personalised software description from writers, NOT JUST cut and paste!

PLEASE DO NOT:

Include logos (even if possible in SPIP)

Attach screenshots (even if possible in SPIP)

Cut and paste (quotations are, of course, accepted, bnut please limit their use)

Enumerate technical uses

Happy writing,

the Website team

Size, language, operating system, programming languages (Perl, C++, C, Java,...), license,...

2004-06-10T13:54:43