14,302
edits
Join the Fediverse:Style guide: Difference between revisions
m
Text replacement - "Internal Link" to "Internal link"
mNo edit summary |
m (Text replacement - "Internal Link" to "Internal link") |
||
| (6 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{Internal page with | 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 | |||
==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 |target=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 |target=What is the Fediverse? |link-name=Fediverse}} we create a link like this {{Ic|<nowiki>{{Internal link |target=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 |target=Hubzilla |link-name=Hubzilla}} instead of {{Internal link |target=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== | ||
| Line 45: | Line 62: | ||
* {{Ic|What is Fediverse project?}}, e.g. [[What is Mastodon?]] is the scheme for basic guides on Fediverse projects. | * {{Ic|What is Fediverse project?}}, e.g. [[What is Mastodon?]] is the scheme for basic guides on Fediverse projects. | ||
* {{Ic|File:Fediverse project logo.svg}}, e.g. [[File:Mastodon logo.svg]] is the name of the official square logo of the project in color. If no svg is available, a png can be uploaded. | * {{Ic|File:Fediverse project logo.svg}}, e.g. [[File:Mastodon logo.svg|20px]] is the name of the official square logo of the project in color. If no svg is available, a png can be uploaded. | ||
* {{Ic|File:Fediverse project.svg}}, e.g. [[File:Mastodon.svg]] is the logo in black. | * {{Ic|File:Fediverse project.svg}}, e.g. [[File:Mastodon.svg|20px]] is the logo in black. | ||
* {{Ic|Fediverse project white.svg}}, e.g. [[File:Mastodon white.svg]] is the logo in white. | * {{Ic|Fediverse project white.svg}}, e.g. <strong style="background-color:black">[[File:Mastodon white.svg|20px]]</strong> is the logo in white (here with a black background, which is not part of the file). | ||
* {{Ic|Fediverse project full logo.svg}}, e.g. [[File:Mastodon full logo.svg]] is a long version of the official logo in color if that exists. | * {{Ic|Fediverse project full logo.svg}}, e.g. [[File:Mastodon full logo.svg|60px]] is a long version of the official logo in color if that exists. | ||
==Headlines== | ==Headlines== | ||
Usually we use {{Ic|<nowiki>==Headline==</nowiki>}} for the largest headline in an article and then add on {{Ic|=}} for each level below. In cases where it's needed another level {{Ic|=Headline=}} can be added above. | Usually we use {{Ic|<nowiki>==Headline==</nowiki>}} for the largest headline in an article and then add on {{Ic|<nowiki>=</nowiki>}} for each level below. In cases where it's needed another level {{Ic|<nowiki>=Headline=</nowiki>}} can be added above. | ||
==Order of projects in lists and tables== | ==Order of projects in lists and tables== | ||
The order of Fediverse projects in lists and tables should follow the order in [[ | The order of Fediverse projects in lists and tables should follow the order in [[Table of all Fediverse projects]]. | ||
{{category |category=Editing guides}} | {{category |category=Editing guides}} | ||