Jump to content

Join the Fediverse:Style guide: Difference between revisions

m
no edit summary
mNo edit summary
Line 1: Line 1:
{{Internal page with issues |text=This guide needs more content.}}
On this page you can find some information about [[Portal:Editing|editing]] this wiki: what you should consider, what might be different than on other wikis. Anything to styling and the way we present content.
This page will gather some guidelines about styling while [[Portal:Editing|editing]].
 
==Links==
 
Generally on wikis that use the Mediawiki software (like e.g. Wikipedia) you create external links like this: {{Ic|<nowiki>[https://wikipedia.org Wikipedia]</nowiki>}} and inthernal links like this {{Ic|<nowiki>[[Main Page|link to main page]]</nowiki>}}. So in both cases the link comes first, but with internal links that's just the name of the article. Then comes the text that should be displayed.<br>
But we do internal links differently. See [[Project:Template_guide#Internal_links]].<br>
We use {{Ic|<nowiki>{{Internal Link |source=Main Page |link-name=link to main page]]</nowiki>}}. This allows the link also to work on translated pages.
 
Each subject mentioned in an article should be linked to the first time it is mentioned. If that would result in a text with lots and lots of links, then just link the articles that are really relevant.<br>
And we should usually link to basic guides/articles about the page, so e.g. if an article mentions the {{Internal Link |source=What is the Fediverse? |link-name=Fediverse}} we create a link like this {{Ic|<nowiki>{{Internal Link |source=What is the Fediverse? |link-name=Fediverse}}</nowiki>}}.<br>
Only if the advanced article (if even two articles exist) is more relevant we link e.g. to {{Internal Link |source=Hubzilla |link-name=Hubzilla}} instead of {{Internal Link |source=What is Hubzilla? |link-name=What is Hubzilla?}}.
 
==Categories==
 
See [[Project:Template_guide#Categories]].<br>
Generally you assign a category to an article by writing e.g. {{Ic|<nowiki>[[Category:Fediverse]]</nowiki>}} somewhere in the article (usually on the bottom). We instead use {{Ic|<nowiki>{{category |category=Fediverse}}</nowiki>}}. This is again to make sure categories work well with translations.<br>
To link to a category we use the standard {{Ic|<nowiki>[[:Category:Fediverse]]</nowiki>}} (note the colon before the word category).
 
Each page (except the main page) should have at least one category (drafts should only have the [[:Category:Drafts]], because we don't want to draw too much attention to them until they are finished). There is no hard limit for how many categories an article can have, but usually 4 are more than enough. Pick the ones most relevant for the topic. E.g. in an article about a Fediverse software, let's say Mastodon, use [[:Category:Mastodon]] but not [[:Category:Fediverse]]. The latter should only be used in general articles about the Fediverse.


==Capitalization==
==Capitalization==