|
|
It:Aiuto:Modificare il Wiki
From NeoWiki
| Revision as of 00:12, 31 December 2006 (edit) Valterb (Talk | contribs) m (change a link to the italian version of the page) ← Previous diff |
Current revision (15:29, 30 November 2008) (edit) (undo) Yakusha ( | contribs) (add link to Dutch version) |
||
| (4 intermediate revisions not shown.) | |||
| Line 3: | Line 3: | ||
| === Informazioni sulle Modifiche e la Sintassi del Wiki === | === Informazioni sulle Modifiche e la Sintassi del Wiki === | ||
| - | * Dal sito | + | * Dal sito MediaWiki |
| + | :http://meta.wikimedia.org/wiki/Help:Reference_card | ||
| :http://meta.wikimedia.org/wiki/Aiuto:Modifica | :http://meta.wikimedia.org/wiki/Aiuto:Modifica | ||
| :http://it.wikipedia.org/wiki/Aiuto:Come_usare_le_tabelle | :http://it.wikipedia.org/wiki/Aiuto:Come_usare_le_tabelle | ||
| Line 26: | Line 27: | ||
| * '''Nuovo Marchio''': consulta la pagina [[Rebranding]] per le più recenti informazioni circa il cambio del nome di NeoOffice/J in NeoOffice nel wiki | * '''Nuovo Marchio''': consulta la pagina [[Rebranding]] per le più recenti informazioni circa il cambio del nome di NeoOffice/J in NeoOffice nel wiki | ||
| - | === | + | |
| + | ===Style and Formatting Guide=== | ||
| When adding new information to the wiki or editing existing information, always adhere to the NeoWiki Style guidelines below: | When adding new information to the wiki or editing existing information, always adhere to the NeoWiki Style guidelines below: | ||
| *'''Menus''', '''submenus''', and '''menu items''' - always use sentences, not "->" or other shorthand. And not just sentences, but sentences that instruct the user on what to do (pull down menus, select buttons, check boxes, etc.) '''in the order that they appear to the user'''. E.g., "In the '''View''' menu, under '''Toolbars''', select '''Customize'''." Names of the menu, submenu, or item are '''boldface'''. | *'''Menus''', '''submenus''', and '''menu items''' - always use sentences, not "->" or other shorthand. And not just sentences, but sentences that instruct the user on what to do (pull down menus, select buttons, check boxes, etc.) '''in the order that they appear to the user'''. E.g., "In the '''View''' menu, under '''Toolbars''', select '''Customize'''." Names of the menu, submenu, or item are '''boldface'''. | ||
| + | ** Or, use the {{Menu|Menu}} template: <tt><nowiki>{{menu|Name of Menu/Menu Item}}</nowiki></tt> | ||
| *"Dialogue/window titles" or "Preference Option Name" - currently, sometimes '''boldface''', sometimes in "quotes" | *"Dialogue/window titles" or "Preference Option Name" - currently, sometimes '''boldface''', sometimes in "quotes" | ||
| *: The format for the above elements has yet to be frozen; they should stand out but also more easily be distinguished from menus and filenames. | *: The format for the above elements has yet to be frozen; they should stand out but also more easily be distinguished from menus and filenames. | ||
| - | + | ** Use the {{Window|Window}} template for dialogue/window titles: <tt><nowiki>{{Window|Title of Window}}</nowiki></tt> | |
| + | ** Use the {{prefName|prefName}} template for preferences/options (selecting a radio button, checkbox, or item from a pop-up menu): <tt><nowiki>{{prefName|Text of Preference/Option}}</nowiki></tt> | ||
| + | ** Use the {{section|Section}} template for names of sub-sections in different preference windows (e.g. Printer Warnings in the Print preferences) or for tabs in a tabbed window: <tt><nowiki>{{section|Name of Preference Section or Tab}}</nowiki></tt> | ||
| + | **: ''See [[:Image:Section_vs_prefName.png]] for an illustration. | ||
| * Buttons - this format needs to decided upon yet. For now, treat as above. | * Buttons - this format needs to decided upon yet. For now, treat as above. | ||
| + | ** Use the {{button|Button}} template: <tt><nowiki>{{button|Name of Button}}</nowiki></tt> | ||
| + | * Keyboard commands (e.g., pressing {{key|return}} or {{key|⌘-S}}, but '''not''' typing a string of text): <tt><nowiki>{{key|name of key/shortcut combination}}</nowiki></tt> | ||
| *'''Filenames''' - standalone—not part of a path—should be '''boldface'''. | *'''Filenames''' - standalone—not part of a path—should be '''boldface'''. | ||
| + | ** '''Application Names''' - when referring to another application in an article (e.g., "Open '''Activity Monitor''' and click…"), use '''boldface'''. | ||
| *<tt>Paths</tt> (including paths ending with a filename) or <tt>Terminal commands</tt> - use the <nowiki><tt></nowiki><tt>typewriter</tt><nowiki></tt></nowiki> tag for single lines or, heaven forbid, the <nowiki><pre></nowiki><pre>preformatted text</pre><nowiki></pre></nowiki> tag for blocks of code. | *<tt>Paths</tt> (including paths ending with a filename) or <tt>Terminal commands</tt> - use the <nowiki><tt></nowiki><tt>typewriter</tt><nowiki></tt></nowiki> tag for single lines or, heaven forbid, the <nowiki><pre></nowiki><pre>preformatted text</pre><nowiki></pre></nowiki> tag for blocks of code. | ||
| Line 73: | Line 82: | ||
| '''Administrative Templates''' | '''Administrative Templates''' | ||
| - | * [[Template:Fixme]], [[Template:Fr:Fixme]] - adds a note to a page needing updates and adds the page to the "Fixme" category | + | * [[Template:Fixme]], [[Template:Fr:Fixme]], [[Template:it:Fixme]], [[Template:es:Fixme]] - adds a note to a page needing updates and adds the page to the "Fixme" category |
| '''Formatting templates''' | '''Formatting templates''' | ||
| Line 111: | Line 120: | ||
| Content | Content | ||
| - | * [[Template: | + | * [[Template:OtherLangs]], [[Template:fr:OtherLangs]], [[Template:de:OtherLangs]], [[Template:it:OtherLangs]], [[Template:es:OtherLangs]] |
| Formatting | Formatting | ||
| Line 174: | Line 183: | ||
| - | {{botlangbarIT|[[Help:Editing|English]] [[Fr:Aide_pour_l'Édition_de_NeoWiki|Français]]}} | + | {{botlangbarIT|[[Help:Editing|English]] [[Fr:Aide_pour_l'Édition_de_NeoWiki|Français]] [[Es:guÃa de estilo|Español]] [[nl:Help:Editing|Nederlands]]}} |
| [[Category:Administrativa]][[Category:Contributing]][[Category:NeoOffice]][[Category:NeoWikiIT]] | [[Category:Administrativa]][[Category:Contributing]][[Category:NeoOffice]][[Category:NeoWikiIT]] | ||
Current revision
Per richiedere un account utente per modificare questa pagina, per favore segui le istruzioni presenti nella pagina Nuovo utente.
Contents |
Informazioni sulle Modifiche e la Sintassi del Wiki
- Dal sito MediaWiki
- http://meta.wikimedia.org/wiki/Help:Reference_card
- http://meta.wikimedia.org/wiki/Aiuto:Modifica
- http://it.wikipedia.org/wiki/Aiuto:Come_usare_le_tabelle
- Da Wikipedia
Politica Stilistica ed Editoriale del NeoWiki
aveva alcune regole sul vecchio wiki. Dicevano qualcosa del tipo:
- Fate in modo che le pagine siano corte. Se una pagina è lunga, probabilmente contiene troppi argomenti e dovrebbe essere divisa in due o più pagine.
- MediaWiki divide le parole del titolo con gli spazi (e li trasforma in underscores negli URL). Dai un titolo alle nuove pagine in modo che questo sia descrittivo.
- NeoJInfo è un pessimo nome/titolo.
- Informazioni su NeoOffice è un buon nome/titolo.
- Non scegliere dei titoli che finiscano con scp o ftp o altre sigle che sono dei protocolli internet conosciuti, o con estensioni comuni per file eseguibili come (exe); il server non visualizzerà queste pagine.
- Aggiungi semnpre un commento che descriva brevemente il cambiamento che hai fatto quando modifichi qualcosa.
- Quando aggiungi una nuova pagina assicurati di includere l'appropriato identificatore di Categoria in fondo alla pagina.
- Raggiungici su Talk:Main_Page per le ultime informazioni del team-wiki!
- Nuovo Marchio: consulta la pagina Rebranding per le più recenti informazioni circa il cambio del nome di NeoOffice/J in NeoOffice nel wiki
Style and Formatting Guide
When adding new information to the wiki or editing existing information, always adhere to the NeoWiki Style guidelines below:
- Menus, submenus, and menu items - always use sentences, not "->" or other shorthand. And not just sentences, but sentences that instruct the user on what to do (pull down menus, select buttons, check boxes, etc.) in the order that they appear to the user. E.g., "In the View menu, under Toolbars, select Customize." Names of the menu, submenu, or item are boldface.
- Or, use the Menu template: {{menu|Name of Menu/Menu Item}}
- "Dialogue/window titles" or "Preference Option Name" - currently, sometimes boldface, sometimes in "quotes"
- The format for the above elements has yet to be frozen; they should stand out but also more easily be distinguished from menus and filenames.
- Use the Window template for dialogue/window titles: {{Window|Title of Window}}
- Use the prefName template for preferences/options (selecting a radio button, checkbox, or item from a pop-up menu): {{prefName|Text of Preference/Option}}
- Use the Section template for names of sub-sections in different preference windows (e.g. Printer Warnings in the Print preferences) or for tabs in a tabbed window: {{section|Name of Preference Section or Tab}}
- See Image:Section_vs_prefName.png for an illustration.
- Buttons - this format needs to decided upon yet. For now, treat as above.
- Use the Button template: {{button|Name of Button}}
- Keyboard commands (e.g., pressing return or ⌘-S, but not typing a string of text): {{key|name of key/shortcut combination}}
- Filenames - standalone—not part of a path—should be boldface.
- Application Names - when referring to another application in an article (e.g., "Open Activity Monitor and click…"), use boldface.
- Paths (including paths ending with a filename) or Terminal commands - use the <tt>typewriter</tt> tag for single lines or, heaven forbid, the <pre>
preformatted text
</pre> tag for blocks of code.
- Use NeoOffice and OpenOffice.org, not Neo and OOo (in certain cases, such as the trademark guidelines or press materials, use NeoOffice® instead).
- While the MediaWiki editing guidelines referenced above call for authors and editors to always sign contributions, the NeoWiki does not adhere to that practice in articles. Similar to an encyclopedia, we want to present a unified article, unbroken by editing dates and user signatures.
- When adding items to Discussion (Talk:) pages, do sign your additions/comments.
Mac vs. Windows/*nix
Since the goal of Neo/J is making OOo more Mac-like, we should always prefer "Mac conventions" where possible; e.g., sending someone to the Activity Monitor utility to quit a hung process instead of ps -aux | grep blah, and using the Preferences... item in the NeoOffice menu rather than the Windows-like Tools menu, Options item.
If something can't be done (or can't be done as easily) without firing up the Terminal, fine, but let's prefer Mac-friendly instructions. (This also conforms with Waldo's points 3-6 in the style guide discussion.)
Notes about URLs in Templates
When including URLs to trinity (or similar pages with ? = & and other characters in them) in templates directly, the characters must be encoded or they'll fubar the display of the template (it seems the = are the most problematic; who'd have thought!?):
From MediaWiki, with a few additions they missed:
Conversion (hexadecimal ASCII value with a percent sign in front):
" # $ % & ' * , : ; < > [ ] ^ ` { | } ? =
%22 %23 %24 %25 %26 %27 %2a %2c %3a %3b %3c %3e %5b %5d %5e %60 %7b %7c %7d %3f %3d
Available Templates
Here is a list of the templates already started for the NeoWiki. (As time permits, I will try to better document the use of them)
See also Guidelines for Translating the NeoWiki#Notes for information on translating templates and the new and deprecated naming schemes for such templates.
( and Phillipe have added several new templates recently [Nov 2005]) - All Templates
Administrative Templates
- Template:Fixme, Template:Fr:Fixme, Template:it:Fixme, Template:es:Fixme - adds a note to a page needing updates and adds the page to the "Fixme" category
Formatting templates
- Template:Bluebox - used on Main Page and in the NeoOffice/J Press Kit
- Template:Alertbox - used for critical alerts
- Template:redbox - used for important notices (non-critical)
- E.g. references to the Trademark Usage Policy on the Build Instructions page and the translations of the Trademark Usage page
- Template:Yellowcolumn - actually pink, used on new Main Page
- Template:Dashedbox
- Template:Handbook sidebar
- Template:Imagebox
- Template:ImageboxRight
- Template:Window - this is "under development" and a first stab at fleshing out the undifferentiated features of the style guide (window title vs. tab/pane title vs. option/setting title, etc.)
- Template:BlueRow - for table alternate row bgcolor
- Template:HeaderRow - for table header bgcolor
- Template:Y - Yes
- Template:N - No
- Template:W - Warning
- Template:Clickpic - Clickable image (used in "Aqua is Here")
Content Templates
- Template:Editor toc
- Template:HistoryTOC - for the NeoHistory article; uses the Handbook sidebar formatting template
- Template:DatabaseTOC - for the database config and use set of articles; uses the Handbook sidebar formatting template
- Template:x11news
- Template:NeoOfficeWords - for the new Main Page
- Template:NeoLightWords - for the new Main Page
- Template:OOoWords - for the new Main Page
- Template:MainPageNewsEN -- content templates for the bluebox in in the Welcome section of the Main Page
- Template:Fr:MainPageNews
- Template:MainPageTerryEN, Template:Fr:MainPageTerry, Template:De:MainPageTerry - Terry Teague memorial
- template:x11sidebar - menu for the side of X11 pages
- Template:NeoPatchVer - neo patch version
- Template:oooversion - OOo version
Wiki Translation Templates
There are also a series of style and content templates specific to the wiki translation efforts; see Guidelines for Translating the NeoWiki for more info about these templates. Please do not replace these templates with other templates or use these templates for other purposes. A non-exhaustive list (will grow as more languages are added) follows.
Content
- Template:OtherLangs, Template:fr:OtherLangs, Template:de:OtherLangs, Template:it:OtherLangs, Template:es:OtherLangs
Formatting
Sandbox
established the Test page for everyone to use to try out editing and wiki techniques without fear of messing up any of the existing pages. If you want to experiment with how the wiki works, do so on that page.
Style Guide Discussion
We should eventually move this section into Help:Editing:Discussion
Do we need to have a "style guide" to standardize how we represent certain functions or types of info?
We have three "regular editors" now, plus a fair amount of legacy content from the old wiki (which had another handful of editors/contributors). We seem to represent only one type of thing consistently among the three of us + legacy content:
- paths (incl. paths ending with a filename) or terminal commands
Other things seem to vary widely:
- Menus submenus (: or -> or something else) Waldo says always use sentences, not "->". And not just sentences, but sentences that instruct the user on what to do (pull down menus, select buttons, check boxes, etc.) in the order that they appear to the user. Ie, "In the View menu, under Toolbars, select Customize."
- Menus (standalone in text, i.e., Choose the Tools menu--sometimes boldface)
- Filenames (standalone--should be boldface)
- "Dialogue/window titles" or "Preference Option Name" (sometimes boldface, sometimes in "quotes")
Should we agree on a wiki style for the latter types and adhere to it from here on out, and clean up the older stuff as we get time or modify those article?
--sardisson 04:27, 29 Apr 2005 (CDT)
Good question. Having worked on a Gentoo wiki or too, i have to say I was impressed with their templates that give a unified look to the whole thing. I think a style guide is not a bad idea.. here are some suggestions.
- bold all filenames, menu items, application names, or any text string that appears on-screen. this will facilitate readability tremendously, especially when following instructions.
- put "pre" or "tt" tags around all typed Terminal commands (or use something similar to the gentoo templates.)
- When describing procedures to be done that involve rooting through menus, list the menu items in the order they appear to the user. for example: "In the menu bar, under the File item, select Save."
- I think that writing directions out in English has several advantages over the "Item 1 > Item 2" method of indicating options/navigation. For one thing, there is not much room for misunderstanding when you say "Make sure that the whatever radio button is selected." or "Press the Ok button to continue." Also, it is more accessible, I think, to a newbie user who may not be familiar with the 'item->item' shorthand.
- When issuing a series of instructions, I think it's always a good idea to express to the user what will happen next, ie "Press the Ok button. A window labeled Preferences will appear."
I'm sure I'll think of more style stuff... this is just a start.. I think the gentoo wiki templates really help unify the site and the navigation stuff facilitates site organization and helps you get around easily.
--Waldo 04:46, 29 Apr 2005 (CDT)
FWIW here is a sample HOWTO I wrote for gentoo. This was the first one I wrote, and it was really easy w/the templates... see how it fits w/the entire site?
--Waldo 05:25, 29 Apr 2005 (CDT)
I'd really like to differentiate window/item titles from filenames and menus; otherwise, I've updated my list of style to match Waldo's text description.
--sardisson 22:34, 2 May 2005 (CDT)
Mac vs. Windows/*nix
Since the goal of Neo/J is making OOo more Mac-like, we should always prefer "Mac conventions" where possible; e.g., sending someone to the Activity Monitor utility to quit a hung process instead of ps -aux | grep blah, and using the Preferences... item in the NeoOffice menu rather than the Windows-like Tools menu, Options item.
If something can't be done (or can't be done as easily) without firing up the Terminal, fine, but let's prefer Mac-friendly instructions. This also conforms with Waldo's points 3-6 above.
--sardisson 04:51, 14 Jul 2005 (CDT)
