Wiki Construction Notes: Difference between revisions

From rejetto wiki
Jump to navigation Jump to search
No edit summary
 
(74 intermediate revisions by 9 users not shown)
Line 1: Line 1:
Everyone is welcome to contribute to this wiki.<br>
Everyone is welcome to contribute to this wiki.
You should however, contact rejetto if you plan a major contribution (which is even more welcome!)


[[Image:MAINICON.png| Main Icon]] PHnote Actually, I think you have to do that to get a username/password ... can't remember??
Remember our motto: "Everything is difficult the first time you do it."<br>
This implies that at first, the wki should concentrate on helping first-time and beginning users; help for experts comes later.<br>
"[[Image:MAINICON.png| Main Icon]] A second objective is to get this as complete as possible for HFS 2.1


If you are in search of information, [[http://meta.wikimedia.org/wiki/Help:Editing Help ]] is the best we've found, so far.
You are not prohibited from writing about older versions (although it's difficult to see why anyone would want to), but you should  make it very clear exactly which version you are writing about.


Many find this [[http://meta.wikimedia.org/wiki/Help:Advanced_editing Formatting]] a very useful information source for formatting details.
Incidentally, if anyone wonders about  what's normally called the "Documentation Problem" --- MicroSoft employ around 75 full-time professional writers permanently devoted to the Help and user-documentation for just one product -- Word. As their development cycle nears its end, this number rises to over 300.<br>
Fortunately, HFS doesn't raise such demands, and anyway, the codes probably better written too.


The above sources suggest that "If you want to try out things without danger of doing any harm, you can do so in the Meta:Sandbox". However, we'd far rather you used your personal sandbox. You can find this under "Personal tools" in the tool bar on the right of the screen It matches your wiki username.
----
===Sources of information===
If you are in search of information about writing in a wiki, [http://meta.wikimedia.org/wiki/Help:Editing Help] is the best we've found, so far. Many find this [http://meta.wikimedia.org/wiki/Help:Advanced_editing Formatting] a very useful information source for layout details.


Graphics (or images in wiki-speak) seem genuinely difficult to manipulate. The best source seems to be [http://en.wikipedia.org/wiki/Wikipedia:Extended_image_syntax Images].
----
===Sandbox===
The above sources suggest that "If you want to try out things without danger of doing any harm, you can do so in the Meta:Sandbox".
However, we'd far rather you used your personal sandbox. You can find this under "Personal tools" in the tool bar on the right of the screen. It matches your wiki username.
----
===Editing policy===
We'd also like to remind you that, under the terms of the Project Copyright Licence, "If you don't want your writing to be edited mercilessly and redistributed at will, then don't submit it here."
We'd also like to remind you that, under the terms of the Project Copyright Licence, "If you don't want your writing to be edited mercilessly and redistributed at will, then don't submit it here."
----


Throughout this wiki you'll see mysterious PHnote markers. These simply indicate to a contributor, whose initials happen to be PH, that something here needs to be fixed.  You're welcome to adopt the same technique, but please use your own initials so that we can contact you in case of difficlty.
===Markers===
Throughout this wiki you'll see mysterious PHnote markers. These simply indicate to a contributor, whose initials happen to be PH, that something here needs to be fixed.  You're welcome to adopt the same technique, but please use your own initials so that we can contact you in case of difficulty.


----
===Menus===
Wrong way to do menus
Wrong way to do menus


Set Upload → upload for accounts → anyone
Set Upload → upload for accounts → anyone


Write! way (matches software, uses italic font, and no spaces)
Right! way (matches software, uses italic font, and no spaces)


''Set Upload&rarr;Upload for accounts&rarr;Anyone''
''Set Upload&rarr;Upload for accounts&rarr;Anyone''


Graphic handling
----
 
===Graphic handling===


We haven't yet worked out the best way to handle screen dumps and other pictures. These are just experiments right now.
We haven't yet worked out the best way to handle screen dumps and other pictures. These are just experiments right now.
[[Image:ss1.png|thumbnail|left|100px|]] <br>
Click to enlarge
[[Image:ss1a.png|First screen]]
One limitation is the disappointingly small size of graphic this wiki can apparently accomodate. This seems to be about the maximum width.
[[Image:073.png|First screen]]


A picture, including alternate text:
[[Image:ss073.PNG|thumbnail|left|100px|]] <br>
Click to enlarge
<br>


[[Image:010.jpg|thumbnail|left|100px|]]


This is the one!
<br>
Click to enlarge.
<br>
<br>
This suggests that the maximum safe size is a width of 480 pixels (12.6 centimetres). Height is not so important, although the above is 280 pixels (7.6 centimetres).


[[Image:ss1.png|thumbnail|left|100px|]]
The ''absolute'' maximum size is a width of 500 pixels (13.2 centimetres):


[[Image:Frame01.png|Max size]]


Aesthetic purists might note that "Golden Rectangle" ideal heights for 500 pixels are 810 pixels and 310 pixels. For 480 pixels, 778 pixels and 298 pixels.


This frame might be useful:


[[Image:Frame02.png]]


See also [[HFS: Gallery]]


----
This is actually an example of a tiny 2x 2 table.


[[Image:ss1.png|First screen]]
{|
| [[Style notes]]  ||  English usage guidelines.
|-
| [[Graphic experiment]] ||  Yet another sandbox.
|}

Latest revision as of 12:53, 19 June 2008

Everyone is welcome to contribute to this wiki.

Remember our motto: "Everything is difficult the first time you do it."
This implies that at first, the wki should concentrate on helping first-time and beginning users; help for experts comes later.

"

Error creating thumbnail: Unable to save thumbnail to destination

A second objective is to get this as complete as possible for HFS 2.1

You are not prohibited from writing about older versions (although it's difficult to see why anyone would want to), but you should make it very clear exactly which version you are writing about.

Incidentally, if anyone wonders about what's normally called the "Documentation Problem" --- MicroSoft employ around 75 full-time professional writers permanently devoted to the Help and user-documentation for just one product -- Word. As their development cycle nears its end, this number rises to over 300.
Fortunately, HFS doesn't raise such demands, and anyway, the codes probably better written too.


Sources of information

If you are in search of information about writing in a wiki, Help is the best we've found, so far. Many find this Formatting a very useful information source for layout details.

Graphics (or images in wiki-speak) seem genuinely difficult to manipulate. The best source seems to be Images.


Sandbox

The above sources suggest that "If you want to try out things without danger of doing any harm, you can do so in the Meta:Sandbox".

However, we'd far rather you used your personal sandbox. You can find this under "Personal tools" in the tool bar on the right of the screen. It matches your wiki username.


Editing policy

We'd also like to remind you that, under the terms of the Project Copyright Licence, "If you don't want your writing to be edited mercilessly and redistributed at will, then don't submit it here."


Markers

Throughout this wiki you'll see mysterious PHnote markers. These simply indicate to a contributor, whose initials happen to be PH, that something here needs to be fixed. You're welcome to adopt the same technique, but please use your own initials so that we can contact you in case of difficulty.


Menus

Wrong way to do menus

Set Upload → upload for accounts → anyone

Right! way (matches software, uses italic font, and no spaces)

Set Upload→Upload for accounts→Anyone


Graphic handling

We haven't yet worked out the best way to handle screen dumps and other pictures. These are just experiments right now.

Error creating thumbnail: Unable to save thumbnail to destination


Click to enlarge


Error creating thumbnail: Unable to save thumbnail to destination


One limitation is the disappointingly small size of graphic this wiki can apparently accomodate. This seems to be about the maximum width.

Error creating thumbnail: Unable to save thumbnail to destination
Error creating thumbnail: Unable to save thumbnail to destination


Click to enlarge





This suggests that the maximum safe size is a width of 480 pixels (12.6 centimetres). Height is not so important, although the above is 280 pixels (7.6 centimetres).

The absolute maximum size is a width of 500 pixels (13.2 centimetres):

Error creating thumbnail: Unable to save thumbnail to destination

Aesthetic purists might note that "Golden Rectangle" ideal heights for 500 pixels are 810 pixels and 310 pixels. For 480 pixels, 778 pixels and 298 pixels.

This frame might be useful:

Error creating thumbnail: Unable to save thumbnail to destination

See also HFS: Gallery


This is actually an example of a tiny 2x 2 table.

Style notes English usage guidelines.
Graphic experiment Yet another sandbox.