Join the Fediverse:Style guide: Difference between revisions

From Join the Fediverse
 
(One intermediate revision by the same user not shown)
Line 65: Line 65:
Articles should have the simplest title possible.
Articles should have the simplest title possible.


For logos of Fediverse projects please follow this scheme:
For logos of Fediverse projects please follow this scheme, otherwise templates won't work.


* {{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 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.
Line 74: Line 74:
==Headlines==
==Headlines==


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.
Usually we use {{Ic|<nowiki>==Headline==</nowiki>}} for the largest headline in an article and then add one {{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==

Latest revision as of 08:14, 20 November 2024

On this page you can find some information about editing this wiki: what you should consider, what might be different than on other wikis. Anything to styling and the way we present content.

Links

Generally on wikis that use the Mediawiki software (like e.g. Wikipedia) you create external links like this: [https://wikipedia.org Wikipedia] and internal links like this [[Main Page|link to main page]]. 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.
But we do internal links differently. See Project:Template_guide#Internal_links.
We use {{Internal link |target=Main Page |link-name=link to main page}}. This allows the link also to work on translated pages.
If the link name should be identical to the target page's title, then you can simply use {{Internal link |target=Main Page}}

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.

Categories

See Project:Template_guide#Categories.
Generally you assign a category to an article by writing e.g. [[Category:Fediverse]] somewhere in the article (usually on the bottom). We instead use {{category |category=Fediverse}}. This is again to make sure categories work well with translations.
To link to a category we use the standard [[:Category:Fediverse]] (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.

The name of a category should be in plural, if it is something that exists in plural. E.g. we have Fediverse projects not project, but Fediverse not Fediverses, obviously.

Capitalization

Capitalization of Software projects, protocols and apps

Capitalization of certain words should be consistent. Here are some examples of Fediverse projects:

First letter in upper case CamelCase all lower case special
  • Fediverse
  • Mastodon
  • Pleroma
  • Lemmy
  • Pixelfed
  • Funkwhale
  • WriteFreely
  • PeerTube
  • BookWyrm
  • GoToSocial
  • ActivityPub
  • lemmur
  • diaspora*
  • (streams)

Capitalization of page titles

Applies to everything that has a page, so including files, templates, categories...

Generally each page title should (also has to) start with an uppercase letter. After that it should be capitalized like a sentence, so almost only words like the ones above should be capitalized.
A namespace is not part of the page title and also has to be capitalized. So an example for a category's full page name would be Category:Example category name about a Fediverse topic.

Unfortunately a lot of pages were created without following this guideline in the past. Please don't rename pages yourself, because that would break every time the page is linked to or similar. Instead let User:Paula know, so she will fix it.

Naming scheme

Articles should have the simplest title possible.

For logos of Fediverse projects please follow this scheme, otherwise templates won't work.

  • File:Fediverse project logo.svg, e.g. is the name of the official square logo of the project in color. If no svg is available, a png can be uploaded.
  • File:Fediverse project.svg, e.g. is the logo in black.
  • Fediverse project white.svg, e.g. is the logo in white (seen here with a black background, which is not part of the file).
  • Fediverse project full logo.svg, e.g. is a long version of the official logo in color if that exists.

Headlines

Usually we use ==Headline== for the largest headline in an article and then add one = for each level below. In cases where it's needed another level =Headline= can be added above.

Order of projects in lists and tables

The order of Fediverse projects in lists and tables should follow the order in Table of all Fediverse projects.