Go to file
WaitSpring 44e67c7b31 fix: 🐛 styles of .mw-halign-center 2024-05-22 14:13:36 +08:00
.github github-actions: bump tj-actions/changed-files from 42 to 44 2024-03-28 00:41:27 +00:00
.husky chore: use Devmoji 2022-09-29 20:39:27 -04:00
.vscode ci: 👷 update package settings 2023-05-08 10:36:30 +08:00
bin Force phpcbf to exit with 0 2019-12-30 19:04:02 -05:00
i18n fix: 🐛 merge from <https://git.qiuwen.wiki/Mirror/mediawiki-skins-Citizen> 2022-12-30 12:05:02 +08:00
includes fix: 🐛 add icon for CiteThisPage 2024-05-01 10:58:44 +08:00
resources fix: 🐛 styles of .mw-halign-center 2024-05-22 14:13:36 +08:00
skinStyles fix: 🐛 class wrap 2024-03-29 11:16:00 +08:00
templates fix(PageTools__languages.mustache): replace icon 2024-01-29 08:29:10 +08:00
.commitlintrc.json ci: lint code to MediaWiki standards 2022-09-30 02:33:57 +00:00
.eslintignore build: 📦️ update lint settings 2024-01-05 14:03:54 +08:00
.eslintrc.json build: 📦️ update package settings 2024-03-28 22:37:24 +08:00
.gitignore Improve CI and code clean up (#143) 2020-06-16 22:49:41 -04:00
.hintrc fix: 🐛 compability 2023-01-05 10:33:11 +08:00
.phpcs.xml chore: update linter config 2021-01-06 19:28:39 -05:00
.stylelintignore build: 📦️ update lint settings 2024-01-05 14:03:54 +08:00
.stylelintrc.json build: 📦️ update package settings 2024-03-28 22:37:24 +08:00
.svgo.config.js build: 📦️ update SVGO settings 2023-11-18 19:56:10 +08:00
.versionrc.json ci: lint code to MediaWiki standards 2022-09-30 02:33:57 +00:00
CHANGELOG.md chore(release): 🚀 2.4.2 2023-02-22 15:13:12 -05:00
CODE_OF_CONDUCT.md docs: 📚️ update CoC 2023-09-30 12:54:36 +08:00
CONTRIBUTING.md fix: 🐛 eslint and stylelint 2022-12-18 13:59:01 +08:00
CREDITS.md fix: 🐛 markdown files 2022-12-20 14:04:10 +08:00
LICENSE licensing update 2019-08-16 21:48:16 -04:00
README.md feat(del): remove support for codeEditor, CodeMirror and SyntaxHighlight 2023-02-24 19:52:18 +08:00
composer.json build(deps-dev): update mediawiki/mediawiki-phan-config requirement 2023-04-25 21:03:05 +00:00
jsdoc.json ci: lint code to MediaWiki standards 2021-04-18 00:41:13 +00:00
package-lock.json ci: 👷 lint code to MediaWiki standards 2024-05-21 08:34:49 +00:00
package.json --- 2024-05-21 00:27:45 +00:00
skin.json fix: 🐛 add quotes icon 2024-05-01 11:10:23 +08:00

README.md

Citizen

Citizen is a beautiful, usable, responsive MediaWiki skin that makes extensions part of the cohesive experience. It was initially created for the Star Citizen Wiki but is flexible to run on various MediaWiki configurations.

Live demo: English, German, Chinese

For the old design, click here 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. ☀️🌙
  • Improved extension UI: Adjust supported extensions to be more usable and cohesive. 🤝🔗
  • 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 A 1.39.0 2022-11-30
Codex A 0.1.1 2022-12-01
OOUI A 0.44.3 2022-11-30

Extensions

Name Grade Version Last updated
AdvancedSearch B REL1_39 3a0eed7 2022-12-12
AJAXPoll A REL1_39 8429d8d 2022-10-25
ApprovedRevs B N/A N/A
Babel B MLEB 2021.07 2021-07-29
Capiunto B REL1_35 30049a7 2021-08-26
Cargo B REL1_35 df13273 2021-08-31
CategoryTree B N/A N/A
CentralNotice B REL1_35 4aa2a8f 2022-06-16
Cite A N/A N/A
CleanChanges B MLEB 2021.07 2021-07-29
CookieWarning A REL1_35 3c2ae6a 2022-04-29
DiscussionTools A REL1_35 7aa0a9b 2022-05-06
DismissableSiteNotice A N/A N/A
Echo A REL1_35 347c30e 2021-08-11
Flow (StructuredDiscussions) B REL1_35 e3379f0 2022-04-27
Graph B N/A N/A
Interwiki B REL1_35 a65a18e 2022-05-15
Lingo B REL1_35 e948775 2022-04-29
Math B REL1_35 b7a7939 2022-08-16
ManageWiki B master 60a2f51 2022-06-16
MediaSearch A REL1_39 e0aa7bb 2022-12-09
MsUpload A REL1_35 32eb420 2021-08-25
MultimediaViewer A REL1_39 1b97775 2022-11-26
OAuth B REL1_35 451ed95 2021-08-31
Popups A REL1_39 a40ebc1 2022-11-28
PortableInfobox B 0.6 16a77dc 2022-04-14
RelatedArticles A REL1_39 f513e5c 2022-11-16
RevisionSlider B REL1_35 4c4e368 2022-06-02
Semantic MediaWiki A 4.0.2 0fcdfce 2022-10-21
Semantic Result Formats E N/A N/A
SimpleTooltip B N/A 2022-02-19
Tabber A N/A N/A
TabberNeue A 1.3.1 656f396 2022-10-23
TimedMediaHandler B N/A N/A
Translate B MLEB 2021.07 2021-07-29
UniversalLanguageSelector B MLEB 2021.12 2022-05-17
UploadWizard A N/A N/A
VisualEditor A REL1_35 cc3466a 2021-08-04
Wikibase B REL1_35 7bb503b 2022-05-11
WikiEditor A REL1_39 02e1c70 2022-11-08
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!

Installation

  1. Download 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 and after all other extensions: 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 on how to adapt Citizen styles on your wiki.

Appearance

Name Description Values Default
$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
$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

Search suggestions

Name Description Values Default
$wgCitizenSearchModule Which ResourceLoader module to use for search suggestion skins.citizen.search; mediawiki.searchSuggest; string skins.citizen.search
$wgCitizenSearchGateway Which gateway to use for fetching search suggestion mwActionApi; mwRestApi; string mwActionApi
$wgCitizenSearchDescriptionSource Source of description text on search suggestions (only takes effect if $wgCitizenSearchGateway is mwActionApi) wikidata - Use description provided by WikibaseLib or ShortDescription; textextracts - Use description provided by TextExtracts; pagedescription - Use description provided by Description2 or any other extension that sets the description page property textextracts
$wgCitizenMaxSearchResults Max number of search suggestions Integer > 0 6

Miscellaneous

Name Description Values Default
$wgCitizenThemeColor The color defined in the theme-color meta tag Hex color code #11151d

Requirements

  • MediaWiki 1.39.0 or later

  • For the legacy versions, check the other release branches.