mirror of
https://github.com/StarCitizenTools/mediawiki-skins-Citizen.git
synced 2024-11-12 00:59:46 +00:00
docs(readme): 📚️ rewrite descriptions in readme
This commit is contained in:
parent
c65f0151da
commit
fbdc15b7f9
261
README.md
261
README.md
|
@ -1,129 +1,132 @@
|
|||
# Citizen
|
||||
[![](https://img.shields.io/github/contributors/StarCitizenTools/mediawiki-skins-Citizen?style=for-the-badge)](https://github.com/StarCitizenTools/mediawiki-skins-Citizen/graphs/contributors) ![](https://img.shields.io/github/workflow/status/StarCitizenTools/mediawiki-skins-Citizen/MediaWiki%20CI?label=MediaWiki%20CI&style=for-the-badge) [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg?style=for-the-badge&logo=appveyor)](https://www.gnu.org/licenses/gpl-3.0) [![MediaWiki: >=1.39.0](https://img.shields.io/badge/MediaWiki-%3E%3D1.39.0-%2336c?style=for-the-badge&logo=appveyor)](https://www.mediawiki.org)[![](https://img.shields.io/badge/translations-translatewiki-%23013467?style=for-the-badge&logo=appveyor)](https://translatewiki.net/w/i.php?title=Special:Translate&group=mwgithub-star-citizen)
|
||||
|
||||
Citizen is a responsive skin for [MediaWiki](https://www.mediawiki.org) built by the [Star Citizen Wiki](https://starcitizen.tools) team. Although it is specifically built for the Star Citizen Wiki, the skin is designed to be flexible to run on any Mediawiki installation that is **1.39.0 or higher**. Due to resource constraints, we might not be able to provide full support for setups that are vastly different than us, but please feel free to submit patches or bug report!
|
||||
|
||||
Live demo can be seen at the [Star Citizen Wiki](https://starcitizen.tools), more avaliable [here](https://wikiapiary.com/wiki/Skin:Citizen).
|
||||
|
||||
If you are looking for the old design, [click here](https://github.com/StarCitizenTools/mediawiki-skins-Citizen/releases/tag/v1.17.9) for the the last 1.X release.
|
||||
|
||||
## Notable features
|
||||
- **Fully responsive skin**: Responsive and able to adapt to different screen sizes. 📱💻🖥️
|
||||
- **Light/dark mode support**: Switch between light and dark mode. ***Require JS*** ☀️🌙
|
||||
- **Adjustable font size and page width**: Read the article the way you wanted. ***Require JS*** 👀📃
|
||||
- **Collapsible sections**: Collapse and expand article sections. ***Require JS*** 📖📕
|
||||
- **Persistent ToC**: Access ToC anywhere in the article. ***Tracking require JS*** 🔍📖
|
||||
- **Rich search suggestions**: More helpful search suggestions with images and descriptions. ***Require JS*** 🔍👀
|
||||
- **Webapp manifest**: Give a more app-like experience when user add your wiki to their home screen. 📱
|
||||
|
||||
## SkinStyles
|
||||
Citizen includes numerous skinStyles that applies custom styling to extensions and core libraries. Please feel free to submit PRs if you want to add support for more extensions! Unless the extension has never supported the current minimum required MediaWiki version of the skin, the skinStyles are based on the latest version of the said MW release branch (e.g. `REL1_35` for MediaWiki 1.35).
|
||||
|
||||
- **Grade A - Overhaul** - Major adjustments to UI, plus Grade B.
|
||||
- **Grade B - Dynamic** - Colors are converted into CSS variables, little to none style adjustments.
|
||||
- **Grade E - Legacy** - Dark mode colors are hardcored as LESS variables. These should be updated to at least Grade B support.
|
||||
|
||||
### Core
|
||||
Name | Grade | Version | Last updated
|
||||
:--- | :--- | :--- | :---
|
||||
MediaWiki UI | B | 1.35.3 | 2021-07-27
|
||||
OOUI | B | 0.39.3 `086b4f1` | 2021-07-26
|
||||
|
||||
### Extensions
|
||||
Name | Grade | Version | Last updated
|
||||
:--- | :--- | :--- | :---
|
||||
[AdvancedSearch](https://www.mediawiki.org/wiki/Extension:AdvancedSearch) | B | REL1_35 `fae6250` | 2021-08-26
|
||||
[AJAXPoll](https://www.mediawiki.org/wiki/Extension:AJAXPoll) | A | REL1_39 `8429d8d` | 2022-10-25
|
||||
[ApprovedRevs](https://www.mediawiki.org/wiki/Extension:Approved_Revs) | B | N/A | N/A
|
||||
[Babel](https://www.mediawiki.org/wiki/Extension:Babel) | B | MLEB 2021.07 | 2021-07-29
|
||||
[Capiunto](https://www.mediawiki.org/wiki/Extension:Capiunto) | B | REL1_35 `30049a7` | 2021-08-26
|
||||
[Cargo](https://www.mediawiki.org/wiki/Extension:Cargo) | B | REL1_35 `df13273` | 2021-08-31
|
||||
[CategoryTree](https://www.mediawiki.org/wiki/Extension:CategoryTree) | B | N/A | N/A
|
||||
[CentralNotice](https://www.mediawiki.org/wiki/Extension:CentralNotice) | B | REL1_35 `4aa2a8f` | 2022-06-16
|
||||
[Cite](https://www.mediawiki.org/wiki/Extension:Cite) | A | N/A | N/A
|
||||
[CleanChanges](https://www.mediawiki.org/wiki/Extension:CleanChanges) | B | MLEB 2021.07 | 2021-07-29
|
||||
[CodeMirror](https://www.mediawiki.org/wiki/Extension:CodeMirror) | A | REL1_35 `a326407` | 2021-08-25
|
||||
[CookieWarning](https://www.mediawiki.org/wiki/Extension:CookieWarning) | A | REL1_35 `3c2ae6a` | 2022-04-29
|
||||
[DiscussionTools](https://www.mediawiki.org/wiki/Extension:DiscussionTools) | A | REL1_35 `7aa0a9b` | 2022-05-06
|
||||
[DismissableSiteNotice](https://www.mediawiki.org/wiki/Extension:DismissableSiteNotice) | A | N/A | N/A
|
||||
[Echo](https://www.mediawiki.org/wiki/Extension:Echo) | A | REL1_35 `347c30e` | 2021-08-11
|
||||
[Flow (StructuredDiscussions)](https://www.mediawiki.org/wiki/Extension:StructuredDiscussions) | B | REL1_35 `e3379f0` | 2022-04-27
|
||||
[Graph](https://www.mediawiki.org/wiki/Extension:Graph) | B | N/A | N/A
|
||||
[Interwiki](https://www.mediawiki.org/wiki/Extension:Interwiki) | B | REL1_35 `a65a18e` | 2022-05-15
|
||||
[Lingo](https://www.mediawiki.org/wiki/Extension:Lingo) | B | REL1_35 `e948775` | 2022-04-29
|
||||
[Math](https://www.mediawiki.org/wiki/Extension:Math) | B | REL1_35 `b7a7939` | 2022-08-16
|
||||
[ManageWiki](https://www.mediawiki.org/wiki/Extension:ManageWiki) | B | master `60a2f51` | 2022-06-16
|
||||
[MsUpload](https://www.mediawiki.org/wiki/Extension:MsUpload) | A | REL1_35 `32eb420` | 2021-08-25
|
||||
[MultimediaViewer](https://www.mediawiki.org/wiki/Extension:MultimediaViewer) | A | N/A | N/A
|
||||
[OAuth](https://www.mediawiki.org/wiki/Extension:OAuth) | B | REL1_35 `451ed95` | 2021-08-31
|
||||
[Popups](https://www.mediawiki.org/wiki/Extension:Popups) | A | REL1_35 `dccd607` | 2021-09-02
|
||||
[PortableInfobox](https://www.mediawiki.org/wiki/Extension:PortableInfobox) | B | 0.6 `16a77dc` | 2022-04-14
|
||||
[RelatedArticles](https://www.mediawiki.org/wiki/Extension:RelatedArticles) | A | REL1_35 `0f27333` | 2021-08-31
|
||||
[RevisionSlider](https://www.mediawiki.org/wiki/Extension:RevisionSlider) | B | REL1_35 `4c4e368` | 2022-06-02
|
||||
[Semantic MediaWiki](https://www.mediawiki.org/wiki/Extension:Semantic_MediaWiki) | A | 4.0.2 `0fcdfce` | 2022-10-21
|
||||
[Semantic Result Formats](https://www.mediawiki.org/wiki/Extension:Semantic_Result_Formats) | E | N/A | N/A
|
||||
[SimpleTooltip](https://www.mediawiki.org/wiki/Extension:SimpleTooltip) | B | N/A | 2022-02-19
|
||||
[SyntaxHighlight](https://www.mediawiki.org/wiki/Extension:SyntaxHighlight) | A | REL1_35 `05598b3` | 2021-08-26
|
||||
[Tabber](https://www.mediawiki.org/wiki/Extension:Tabber) | A | N/A | N/A
|
||||
[TabberNeue](https://www.mediawiki.org/wiki/Extension:TabberNeue) | A | 1.3.1 `656f396` | 2022-10-23
|
||||
[TimedMediaHandler](https://www.mediawiki.org/wiki/Extension:TimedMediaHandler) | B | N/A | N/A
|
||||
[Translate](https://www.mediawiki.org/wiki/Extension:Translate) | B | MLEB 2021.07 | 2021-07-29
|
||||
[UniversalLanguageSelector](https://www.mediawiki.org/wiki/Extension:UniversalLanguageSelector) | B | MLEB 2021.12 | 2022-05-17
|
||||
[UploadWizard](https://www.mediawiki.org/wiki/Extension:UploadWizard) | A | N/A | N/A
|
||||
[VisualEditor](https://www.mediawiki.org/wiki/Extension:VisualEditor) | A | REL1_35 `cc3466a` | 2021-08-04
|
||||
[Wikibase](https://www.mediawiki.org/wiki/Extension:Wikibase) | B | REL1_35 `7bb503b` | 2022-05-11
|
||||
[WikiEditor](https://www.mediawiki.org/wiki/Extension:WikiEditor) | A | REL1_39 `02e1c70` | 2022-11-08
|
||||
[WSSearchFront](https://www.mediawiki.org/wiki/Extension:WSSearchFront) | B | 3.5.4 `c27ebcb5` | 2021-11-23
|
||||
|
||||
Some of the field are tagged as N/A because the information was not tracked before.
|
||||
If you are interested in adding skinstyles, please check out [this page on the wiki](https://github.com/StarCitizenTools/mediawiki-skins-Citizen/wiki/Adding-extension-SkinStyles)!
|
||||
|
||||
## Installation
|
||||
1. [Download](https://github.com/StarCitizenTools/mediawiki-skins-Citizen/archive/main.zip) place the file(s) in a directory called `Citizen` in your `skins/` folder.
|
||||
2. Add the following code at the bottom of your LocalSettings.php:
|
||||
```php
|
||||
wfLoadSkin( 'Citizen' );
|
||||
```
|
||||
3. **✔️Done** - Navigate to Special:Version on your wiki to verify that the skin is successfully installed.
|
||||
|
||||
## Configurations
|
||||
**The skin works out of the box without any configurations.**
|
||||
The config flags allow more customization on the specific features in the skin.
|
||||
Check out [this wiki page](https://github.com/StarCitizenTools/mediawiki-skins-Citizen/wiki/Adapting-Citizen-styles) on how to adapt Citizen styles on your wiki.
|
||||
|
||||
### Appearance
|
||||
Name | Description | Values | Default
|
||||
:--- | :--- | :--- | :---
|
||||
`$wgCitizenThemeDefault` | The default theme of the skin | `auto` - switch between light and dark according to OS/browser settings; `light`; `dark` | `auto`
|
||||
`$wgCitizenEnableCollapsibleSections` | Enables or disable collapsible sections on content pages | `true` - enable; `false` - disable | `true`
|
||||
`$wgCitizenShowPageTools` | The condition of page tools visibility | `true` - always visible; `login` - visible to logged-in users; `permission` - visible to users with the right permissions | `true`
|
||||
`$wgCitizenGlobalToolsPortlet` | ID of the portlet to attach the global tools | string |
|
||||
`$wgCitizenEnableDrawerSiteStats` | Enables the site statistics in drawer menu | `true` - enable; `false` - disable | `true`
|
||||
`$wgCitizenUseNumberFormatter` | Use NumberFormatter for site statistics, which allows formatting number in a localized way | `true` - enable; `false` - disable | `true`
|
||||
`$wgCitizenThemeColor` | The color defined in the `theme-color` meta tag | Hex color code | `#131a21`
|
||||
`$wgCitizenEnableCJKFonts` | Enable included Noto Sans CJK for wikis that serves CJK languages | `true` - enable; `false` - disable | `false`
|
||||
|
||||
### Search suggestions
|
||||
Name | Description | Values | Default
|
||||
:--- | :--- | :--- | :---
|
||||
`$wgCitizenEnableSearch` | Enable or disable rich search suggestions |`true` - enable; `false` - disable | `true`
|
||||
`$wgCitizenSearchGateway` | Which gateway to use for fetching search suggestion |`mwActionApi`; `mwRestApi` | `mwActionApi`
|
||||
`$wgCitizenSearchDescriptionSource` | Source of description text on search suggestions (only takes effect if `$wgCitizenSearchGateway` is `mwActionApi`) | `wikidata` - Use description provided by [WikibaseLib](Extension:WikibaseLib) or [ShortDescription](https://www.mediawiki.org/wiki/Extension:ShortDescription); `textextracts` - Use description provided by [TextExtracts](https://www.mediawiki.org/wiki/Extension:TextExtracts); `pagedescription` - Use description provided by [Description2](https://www.mediawiki.org/wiki/Extension:Description2) or any other extension that sets the `description` page property | `textextracts`
|
||||
`$wgCitizenMaxSearchResults` | Max number of search suggestions | Integer > 0 | `6`
|
||||
|
||||
### Webapp manifest
|
||||
Name | Description | Values | Default
|
||||
:--- | :--- | :--- | :---
|
||||
`$wgCitizenEnableManifest` | Enable or disable [web app manifest](https://developer.mozilla.org/en-US/docs/Web/Manifest) | `true` - enable; `false` - disable | `true`
|
||||
`$wgCitizenManifestThemeColor` | [Theme color](https://developer.mozilla.org/en-US/docs/Web/Manifest/theme_color) of the web app manifest | Hex color code | `#131a21`
|
||||
`$wgCitizenManifestBackgroundColor` | [Background color](https://developer.mozilla.org/en-US/docs/Web/Manifest/background_color) of the web app manifest | Hex color code | `#131a21`
|
||||
|
||||
### Miscellaneous
|
||||
Name | Description | Values | Default
|
||||
:--- | :--- | :--- | :---
|
||||
`$wgCitizenThemeColor` | The color defined in the `theme-color` meta tag | Hex color code | `#11151d`
|
||||
|
||||
## Requirements
|
||||
* [MediaWiki](https://www.mediawiki.org) 1.39.0 or later
|
||||
* For the legacy versions, check the other release branches.
|
||||
|
||||
# Citizen
|
||||
[![](https://img.shields.io/github/contributors/StarCitizenTools/mediawiki-skins-Citizen?style=for-the-badge)](https://github.com/StarCitizenTools/mediawiki-skins-Citizen/graphs/contributors) ![](https://img.shields.io/github/workflow/status/StarCitizenTools/mediawiki-skins-Citizen/MediaWiki%20CI?label=MediaWiki%20CI&style=for-the-badge) [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg?style=for-the-badge&logo=appveyor)](https://www.gnu.org/licenses/gpl-3.0) [![MediaWiki: >=1.39.0](https://img.shields.io/badge/MediaWiki-%3E%3D1.39.0-%2336c?style=for-the-badge&logo=appveyor)](https://www.mediawiki.org)[![](https://img.shields.io/badge/translations-translatewiki-%23013467?style=for-the-badge&logo=appveyor)](https://translatewiki.net/w/i.php?title=Special:Translate&group=mwgithub-star-citizen)
|
||||
|
||||
Citizen is a beautiful, usable, responsive [MediaWiki](https://www.mediawiki.org) skin that makes [extensions](https://www.mediawiki.org/wiki/Manual:Extensions) part of the cohesive experience. It was initially created for the [Star Citizen Wiki](https://starcitizen.tools) but is flexible to run on various MediaWiki configurations.
|
||||
|
||||
Live demo: [English](https://starcitizen.tools), [German](https://star-citizen.wiki), [Chinese](https://sctoolszh.miraheze.org)
|
||||
|
||||
For the old design, [click here](https://github.com/StarCitizenTools/mediawiki-skins-Citizen/releases/tag/v1.17.9) for the last release.
|
||||
|
||||
## Notable features
|
||||
- **Responsive layout**: Responsive and able to adapt to different screen sizes. 📱💻🖥️
|
||||
- **Light/dark mode**: Switch between light and dark mode. ☀️🌙
|
||||
- **Cohesive extension styles**: Supported extensions blend with the rest of the UI. 🤝🔗
|
||||
- **Reading preferences**: Adjust page width, font size, and line height. 👀📃
|
||||
- **Collapsible sections**: Collapse and expand article sections. 📖📕
|
||||
- **Persistent ToC**: Access ToC anywhere in the article. 🔍📖
|
||||
- **Rich search suggestions**: More helpful search suggestions with images and descriptions. 🔍👀
|
||||
- **Progressive Web App**: Give a more app-like experience when user add your wiki to their home screen. 📱
|
||||
|
||||
## Extension styles
|
||||
Citizen overrides some extension styles through skinStyles that applies custom styling to extensions and core libraries.
|
||||
|
||||
- **Grade A - Overhaul** - Major adjustments to UI, plus Grade B.
|
||||
- **Grade B - Dynamic** - Colors are converted into CSS variables, little to none style adjustments.
|
||||
- **Grade E - Legacy** - Dark mode colors are hardcored as LESS variables. These should be updated to at least Grade B support.
|
||||
|
||||
Please feel free to submit PRs if you want to add support for more extensions!
|
||||
|
||||
### Core
|
||||
Name | Grade | Version | Last updated
|
||||
:--- | :--- | :--- | :---
|
||||
MediaWiki UI | B | 1.35.3 | 2021-07-27
|
||||
OOUI | B | 0.39.3 `086b4f1` | 2021-07-26
|
||||
|
||||
### Extensions
|
||||
Name | Grade | Version | Last updated
|
||||
:--- | :--- | :--- | :---
|
||||
[AdvancedSearch](https://www.mediawiki.org/wiki/Extension:AdvancedSearch) | B | REL1_35 `fae6250` | 2021-08-26
|
||||
[AJAXPoll](https://www.mediawiki.org/wiki/Extension:AJAXPoll) | A | REL1_39 `8429d8d` | 2022-10-25
|
||||
[ApprovedRevs](https://www.mediawiki.org/wiki/Extension:Approved_Revs) | B | N/A | N/A
|
||||
[Babel](https://www.mediawiki.org/wiki/Extension:Babel) | B | MLEB 2021.07 | 2021-07-29
|
||||
[Capiunto](https://www.mediawiki.org/wiki/Extension:Capiunto) | B | REL1_35 `30049a7` | 2021-08-26
|
||||
[Cargo](https://www.mediawiki.org/wiki/Extension:Cargo) | B | REL1_35 `df13273` | 2021-08-31
|
||||
[CategoryTree](https://www.mediawiki.org/wiki/Extension:CategoryTree) | B | N/A | N/A
|
||||
[CentralNotice](https://www.mediawiki.org/wiki/Extension:CentralNotice) | B | REL1_35 `4aa2a8f` | 2022-06-16
|
||||
[Cite](https://www.mediawiki.org/wiki/Extension:Cite) | A | N/A | N/A
|
||||
[CleanChanges](https://www.mediawiki.org/wiki/Extension:CleanChanges) | B | MLEB 2021.07 | 2021-07-29
|
||||
[CodeMirror](https://www.mediawiki.org/wiki/Extension:CodeMirror) | A | REL1_35 `a326407` | 2021-08-25
|
||||
[CookieWarning](https://www.mediawiki.org/wiki/Extension:CookieWarning) | A | REL1_35 `3c2ae6a` | 2022-04-29
|
||||
[DiscussionTools](https://www.mediawiki.org/wiki/Extension:DiscussionTools) | A | REL1_35 `7aa0a9b` | 2022-05-06
|
||||
[DismissableSiteNotice](https://www.mediawiki.org/wiki/Extension:DismissableSiteNotice) | A | N/A | N/A
|
||||
[Echo](https://www.mediawiki.org/wiki/Extension:Echo) | A | REL1_35 `347c30e` | 2021-08-11
|
||||
[Flow (StructuredDiscussions)](https://www.mediawiki.org/wiki/Extension:StructuredDiscussions) | B | REL1_35 `e3379f0` | 2022-04-27
|
||||
[Graph](https://www.mediawiki.org/wiki/Extension:Graph) | B | N/A | N/A
|
||||
[Interwiki](https://www.mediawiki.org/wiki/Extension:Interwiki) | B | REL1_35 `a65a18e` | 2022-05-15
|
||||
[Lingo](https://www.mediawiki.org/wiki/Extension:Lingo) | B | REL1_35 `e948775` | 2022-04-29
|
||||
[Math](https://www.mediawiki.org/wiki/Extension:Math) | B | REL1_35 `b7a7939` | 2022-08-16
|
||||
[ManageWiki](https://www.mediawiki.org/wiki/Extension:ManageWiki) | B | master `60a2f51` | 2022-06-16
|
||||
[MsUpload](https://www.mediawiki.org/wiki/Extension:MsUpload) | A | REL1_35 `32eb420` | 2021-08-25
|
||||
[MultimediaViewer](https://www.mediawiki.org/wiki/Extension:MultimediaViewer) | A | N/A | N/A
|
||||
[OAuth](https://www.mediawiki.org/wiki/Extension:OAuth) | B | REL1_35 `451ed95` | 2021-08-31
|
||||
[Popups](https://www.mediawiki.org/wiki/Extension:Popups) | A | REL1_35 `dccd607` | 2021-09-02
|
||||
[PortableInfobox](https://www.mediawiki.org/wiki/Extension:PortableInfobox) | B | 0.6 `16a77dc` | 2022-04-14
|
||||
[RelatedArticles](https://www.mediawiki.org/wiki/Extension:RelatedArticles) | A | REL1_35 `0f27333` | 2021-08-31
|
||||
[RevisionSlider](https://www.mediawiki.org/wiki/Extension:RevisionSlider) | B | REL1_35 `4c4e368` | 2022-06-02
|
||||
[Semantic MediaWiki](https://www.mediawiki.org/wiki/Extension:Semantic_MediaWiki) | A | 4.0.2 `0fcdfce` | 2022-10-21
|
||||
[Semantic Result Formats](https://www.mediawiki.org/wiki/Extension:Semantic_Result_Formats) | E | N/A | N/A
|
||||
[SimpleTooltip](https://www.mediawiki.org/wiki/Extension:SimpleTooltip) | B | N/A | 2022-02-19
|
||||
[SyntaxHighlight](https://www.mediawiki.org/wiki/Extension:SyntaxHighlight) | A | REL1_35 `05598b3` | 2021-08-26
|
||||
[Tabber](https://www.mediawiki.org/wiki/Extension:Tabber) | A | N/A | N/A
|
||||
[TabberNeue](https://www.mediawiki.org/wiki/Extension:TabberNeue) | A | 1.3.1 `656f396` | 2022-10-23
|
||||
[TimedMediaHandler](https://www.mediawiki.org/wiki/Extension:TimedMediaHandler) | B | N/A | N/A
|
||||
[Translate](https://www.mediawiki.org/wiki/Extension:Translate) | B | MLEB 2021.07 | 2021-07-29
|
||||
[UniversalLanguageSelector](https://www.mediawiki.org/wiki/Extension:UniversalLanguageSelector) | B | MLEB 2021.12 | 2022-05-17
|
||||
[UploadWizard](https://www.mediawiki.org/wiki/Extension:UploadWizard) | A | N/A | N/A
|
||||
[VisualEditor](https://www.mediawiki.org/wiki/Extension:VisualEditor) | A | REL1_35 `cc3466a` | 2021-08-04
|
||||
[Wikibase](https://www.mediawiki.org/wiki/Extension:Wikibase) | B | REL1_35 `7bb503b` | 2022-05-11
|
||||
[WikiEditor](https://www.mediawiki.org/wiki/Extension:WikiEditor) | A | REL1_39 `02e1c70` | 2022-11-08
|
||||
[WSSearchFront](https://www.mediawiki.org/wiki/Extension:WSSearchFront) | B | 3.5.4 `c27ebcb5` | 2021-11-23
|
||||
|
||||
Some of the field are tagged as N/A because the information was not tracked before.
|
||||
If you are interested in adding skinstyles, please check out [this page on the wiki](https://github.com/StarCitizenTools/mediawiki-skins-Citizen/wiki/Adding-extension-SkinStyles)!
|
||||
|
||||
## Installation
|
||||
1. [Download](https://github.com/StarCitizenTools/mediawiki-skins-Citizen/archive/main.zip) place the file(s) in a directory called `Citizen` in your `skins/` folder.
|
||||
2. Add the following code at the bottom of your LocalSettings.php:
|
||||
```php
|
||||
wfLoadSkin( 'Citizen' );
|
||||
```
|
||||
3. **✔️Done** - Navigate to Special:Version on your wiki to verify that the skin is successfully installed.
|
||||
|
||||
## Configurations
|
||||
**The skin works out of the box without any configurations.**
|
||||
The config flags allow more customization on the specific features in the skin.
|
||||
Check out [this wiki page](https://github.com/StarCitizenTools/mediawiki-skins-Citizen/wiki/Adapting-Citizen-styles) on how to adapt Citizen styles on your wiki.
|
||||
|
||||
### Appearance
|
||||
Name | Description | Values | Default
|
||||
:--- | :--- | :--- | :---
|
||||
`$wgCitizenThemeDefault` | The default theme of the skin | `auto` - switch between light and dark according to OS/browser settings; `light`; `dark` | `auto`
|
||||
`$wgCitizenEnableCollapsibleSections` | Enables or disable collapsible sections on content pages | `true` - enable; `false` - disable | `true`
|
||||
`$wgCitizenShowPageTools` | The condition of page tools visibility | `true` - always visible; `login` - visible to logged-in users; `permission` - visible to users with the right permissions | `true`
|
||||
`$wgCitizenGlobalToolsPortlet` | ID of the portlet to attach the global tools | string |
|
||||
`$wgCitizenEnableDrawerSiteStats` | Enables the site statistics in drawer menu | `true` - enable; `false` - disable | `true`
|
||||
`$wgCitizenUseNumberFormatter` | Use NumberFormatter for site statistics, which allows formatting number in a localized way | `true` - enable; `false` - disable | `true`
|
||||
`$wgCitizenThemeColor` | The color defined in the `theme-color` meta tag | Hex color code | `#131a21`
|
||||
`$wgCitizenEnableCJKFonts` | Enable included Noto Sans CJK for wikis that serves CJK languages | `true` - enable; `false` - disable | `false`
|
||||
|
||||
### Search suggestions
|
||||
Name | Description | Values | Default
|
||||
:--- | :--- | :--- | :---
|
||||
`$wgCitizenEnableSearch` | Enable or disable rich search suggestions |`true` - enable; `false` - disable | `true`
|
||||
`$wgCitizenSearchGateway` | Which gateway to use for fetching search suggestion |`mwActionApi`; `mwRestApi` | `mwActionApi`
|
||||
`$wgCitizenSearchDescriptionSource` | Source of description text on search suggestions (only takes effect if `$wgCitizenSearchGateway` is `mwActionApi`) | `wikidata` - Use description provided by [WikibaseLib](Extension:WikibaseLib) or [ShortDescription](https://www.mediawiki.org/wiki/Extension:ShortDescription); `textextracts` - Use description provided by [TextExtracts](https://www.mediawiki.org/wiki/Extension:TextExtracts); `pagedescription` - Use description provided by [Description2](https://www.mediawiki.org/wiki/Extension:Description2) or any other extension that sets the `description` page property | `textextracts`
|
||||
`$wgCitizenMaxSearchResults` | Max number of search suggestions | Integer > 0 | `6`
|
||||
|
||||
### Webapp manifest
|
||||
Name | Description | Values | Default
|
||||
:--- | :--- | :--- | :---
|
||||
`$wgCitizenEnableManifest` | Enable or disable [web app manifest](https://developer.mozilla.org/en-US/docs/Web/Manifest) | `true` - enable; `false` - disable | `true`
|
||||
`$wgCitizenManifestThemeColor` | [Theme color](https://developer.mozilla.org/en-US/docs/Web/Manifest/theme_color) of the web app manifest | Hex color code | `#131a21`
|
||||
`$wgCitizenManifestBackgroundColor` | [Background color](https://developer.mozilla.org/en-US/docs/Web/Manifest/background_color) of the web app manifest | Hex color code | `#131a21`
|
||||
|
||||
### Miscellaneous
|
||||
Name | Description | Values | Default
|
||||
:--- | :--- | :--- | :---
|
||||
`$wgCitizenThemeColor` | The color defined in the `theme-color` meta tag | Hex color code | `#11151d`
|
||||
|
||||
## Requirements
|
||||
* [MediaWiki](https://www.mediawiki.org) 1.39.0 or later
|
||||
* For the legacy versions, check the other release branches.
|
||||
|
||||
|
|
92
i18n/en.json
92
i18n/en.json
|
@ -1,46 +1,46 @@
|
|||
{
|
||||
"@metadata": {
|
||||
"authors": [
|
||||
"[https://www.mediawiki.org/wiki/User:Alistair3149 Alistair3149]",
|
||||
"[https://www.mediawiki.org/wiki/User:Octfx Octfx]"
|
||||
]
|
||||
},
|
||||
"skinname-citizen": "Citizen",
|
||||
"citizen-skin-desc": "A beautiful, usable, and responsive skin with in-depth extension support. Originally developed for the [https://starcitizen.tools/ Star Citizen Wiki].",
|
||||
"citizen-prefs-talkpage": "[[mw:Skin_talk:Citizen|Discussion]]",
|
||||
"citizen.css": "/* All CSS here will be loaded for users of the Citizen skin */",
|
||||
"citizen.js": "/* All JavaScript here will be loaded for users of the Citizen skin */",
|
||||
"citizen-drawer-toggle": "Toggle menu",
|
||||
"citizen-usermenu-toggle": "Toggle personal menu",
|
||||
"citizen-search-toggle": "Toggle search",
|
||||
"citizen-languages-toggle": "More languages",
|
||||
"citizen-actions-more-toggle": "More actions",
|
||||
"citizen-sitestats-articles-label": "articles",
|
||||
"citizen-sitestats-images-label": "files",
|
||||
"citizen-sitestats-users-label": "users",
|
||||
"citizen-sitestats-edits-label": "edits",
|
||||
"citizen-page-info-copyright": "Copyright",
|
||||
"citizen-page-info-credits": "Credits",
|
||||
"citizen-page-info-lastmod": "Last modified",
|
||||
"citizen-footer-desc": "Edit this text on [[MediaWiki:Citizen-footer-desc]]",
|
||||
"citizen-footer-tagline": "Edit this text on [[MediaWiki:Citizen-footer-tagline]]",
|
||||
"citizen-action-addsection": "Add topic",
|
||||
"citizen-jumptotop": "Back to top",
|
||||
"citizen-search-fulltext": "Search pages containing",
|
||||
"citizen-search-fulltext-empty": "Type to start searching",
|
||||
"citizen-tagline-ns-talk": "Discussion page of {{SUBJECTPAGENAME}}",
|
||||
"citizen-tagline-ns-project": "Information about {{SITENAME}}",
|
||||
"citizen-tagline-ns-file": "File on {{SITENAME}}",
|
||||
"citizen-tagline-ns-mediawiki": "MediaWiki interface page",
|
||||
"citizen-tagline-ns-template": "Template page",
|
||||
"citizen-tagline-ns-help": "Help page",
|
||||
"citizen-tagline-ns-category": "Category page",
|
||||
"prefs-citizen-theme-label": "Theme",
|
||||
"prefs-citizen-theme-option-auto": "Auto",
|
||||
"prefs-citizen-theme-option-light": "Light",
|
||||
"prefs-citizen-theme-option-dark": "Dark",
|
||||
"prefs-citizen-fontsize-label": "Font size",
|
||||
"prefs-citizen-pagewidth-label": "Page width",
|
||||
"prefs-citizen-lineheight-label": "Line height",
|
||||
"prefs-citizen-resetbutton-label": "Reset to default"
|
||||
}
|
||||
{
|
||||
"@metadata": {
|
||||
"authors": [
|
||||
"[https://www.mediawiki.org/wiki/User:Alistair3149 Alistair3149]",
|
||||
"[https://www.mediawiki.org/wiki/User:Octfx Octfx]"
|
||||
]
|
||||
},
|
||||
"skinname-citizen": "Citizen",
|
||||
"citizen-skin-desc": "A beautiful, usable, responsive MediaWiki skin that makes extensions part of the cohesive experience. Initially created for the [https://starcitizen.tools/ Star Citizen Wiki].",
|
||||
"citizen-prefs-talkpage": "[[mw:Skin_talk:Citizen|Discussion]]",
|
||||
"citizen.css": "/* All CSS here will be loaded for users of the Citizen skin */",
|
||||
"citizen.js": "/* All JavaScript here will be loaded for users of the Citizen skin */",
|
||||
"citizen-drawer-toggle": "Toggle menu",
|
||||
"citizen-usermenu-toggle": "Toggle personal menu",
|
||||
"citizen-search-toggle": "Toggle search",
|
||||
"citizen-languages-toggle": "More languages",
|
||||
"citizen-actions-more-toggle": "More actions",
|
||||
"citizen-sitestats-articles-label": "articles",
|
||||
"citizen-sitestats-images-label": "files",
|
||||
"citizen-sitestats-users-label": "users",
|
||||
"citizen-sitestats-edits-label": "edits",
|
||||
"citizen-page-info-copyright": "Copyright",
|
||||
"citizen-page-info-credits": "Credits",
|
||||
"citizen-page-info-lastmod": "Last modified",
|
||||
"citizen-footer-desc": "Edit this text on [[MediaWiki:Citizen-footer-desc]]",
|
||||
"citizen-footer-tagline": "Edit this text on [[MediaWiki:Citizen-footer-tagline]]",
|
||||
"citizen-action-addsection": "Add topic",
|
||||
"citizen-jumptotop": "Back to top",
|
||||
"citizen-search-fulltext": "Search pages containing",
|
||||
"citizen-search-fulltext-empty": "Type to start searching",
|
||||
"citizen-tagline-ns-talk": "Discussion page of {{SUBJECTPAGENAME}}",
|
||||
"citizen-tagline-ns-project": "Information about {{SITENAME}}",
|
||||
"citizen-tagline-ns-file": "File on {{SITENAME}}",
|
||||
"citizen-tagline-ns-mediawiki": "MediaWiki interface page",
|
||||
"citizen-tagline-ns-template": "Template page",
|
||||
"citizen-tagline-ns-help": "Help page",
|
||||
"citizen-tagline-ns-category": "Category page",
|
||||
"prefs-citizen-theme-label": "Theme",
|
||||
"prefs-citizen-theme-option-auto": "Auto",
|
||||
"prefs-citizen-theme-option-light": "Light",
|
||||
"prefs-citizen-theme-option-dark": "Dark",
|
||||
"prefs-citizen-fontsize-label": "Font size",
|
||||
"prefs-citizen-pagewidth-label": "Page width",
|
||||
"prefs-citizen-lineheight-label": "Line height",
|
||||
"prefs-citizen-resetbutton-label": "Reset to default"
|
||||
}
|
||||
|
|
Loading…
Reference in a new issue