{"id":13856642,"url":"https://github.com/OSAS/strapping-mediawiki","last_synced_at":"2025-07-13T19:32:05.474Z","repository":{"id":6408873,"uuid":"7647104","full_name":"OSAS/strapping-mediawiki","owner":"OSAS","description":"base skin for MediaWiki, based on Bootstrap — layer your own style (fonts, graphics, color) on top","archived":true,"fork":false,"pushed_at":"2016-07-29T10:35:29.000Z","size":1075,"stargazers_count":146,"open_issues_count":37,"forks_count":35,"subscribers_count":36,"default_branch":"master","last_synced_at":"2024-08-06T03:01:59.661Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OSAS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-01-16T14:27:05.000Z","updated_at":"2023-05-20T08:55:31.000Z","dependencies_parsed_at":"2022-08-28T07:01:42.109Z","dependency_job_id":null,"html_url":"https://github.com/OSAS/strapping-mediawiki","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OSAS%2Fstrapping-mediawiki","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OSAS%2Fstrapping-mediawiki/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OSAS%2Fstrapping-mediawiki/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OSAS%2Fstrapping-mediawiki/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OSAS","download_url":"https://codeload.github.com/OSAS/strapping-mediawiki/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225912205,"owners_count":17544120,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-05T03:01:07.123Z","updated_at":"2024-11-22T14:30:28.041Z","avatar_url":"https://github.com/OSAS.png","language":"PHP","funding_links":[],"categories":["PHP"],"sub_categories":[],"readme":"# Strapping, a friendly starter theme for MediaWiki\n\nStrapping is an elegant, responsive, and friendly starter skin for MediaWiki.\nIts purpose is to provide a good base to build upon,\nand was primarily created to provide a great default for wiki-as-a-website\n— but it works well for standard wikis too.\n\nStrapping is built on top of a modified Vector theme from **[MediaWiki](http://mediawiki.org/)**\nand utilizes **[Bootstrap](http://getbootstrap.com/)**\n(currently Bootstrap 2; soon to be upgraded)\nfor base layout, typography, and additional widgets.\n\nBecause Strapping uses Bootstrap with its responsive extension,\nany site using this skin works well on desktop browsers\nand scales down to display beautifully on hand-held devices\nlike tablets and smartphones.\n\nStrapping also has complete coverage for all of MediaWiki,\nincluding the user preferences and admin pages.\nAll of MediaWiki's features are included, too.\n\n\n## Origin (and demo) of Strapping\n\nStrapping was made from the need of reworking oVirt.org look attractive,\nhave one place for everyone to edit content\n(instead of a mix of WordPress and MediaWiki),\nand have an easy-to-work with site\nso that anyone could either stick to MediaWiki marked up pages\nor do some more advanced layout (with columns, etc.) using Bootstrap.\n\nYou can see a (customized) instance of Strapping in action by visiting http://oVirt.org/\n\n\n## Requirements\n\n* Webserver with PHP (needed for MediaWiki)\n* MediaWiki 1.18.1 or higher (1.18.1 was the first release with jQuery 1.7+, needed for Bootstrap)\n\n\n## Get started\n\n1. Change to the \"skins\" subdirectory of your MediaWiki installation:\n\n   ```\n   cd skins\n   ```\n\n2. Clone the repository:\n\n   ```\n   git clone https://github.com/OSAS/strapping-mediawiki strapping\n   ```\n\n3. Add the following to `LocalSettings.php`: \n\n   ```php\n   require_once( \"$IP/skins/strapping/strapping.php\" );\n   $wgDefaultSkin = \"strapping\";\n   ```\n   \n   (You may safely remove or comment out other mentions of\n   `$wgDefaultSkin`.)\n\n4. Edit the wiki page `MediaWiki:Sidebar` with your web browser\n   to change your navigation links.\n\n5. Customize the skin to make the site look how you'd want.\n   (See \"Customization\", below.)\n\n\n### Optional configuration\n\n#### Wiki-as-a-website (no edit links or toolbar)\n\nStrapping was originally designed to be used in a wiki-as-a-website mode,\nwhere, to someone not signed in, it would be unable to notice\nthat the site is powered by MediaWiki.\n(If someone is signed in and has access,\nthen \"edit\" links and the toolbar appear.)\n\nYou can either leave full edit access available to anyone\n(even anonymous editors), which is the default for MediaWiki,\nor lock it down a bit.\n\nTo operate in this mode, add the following to `LocalSettings.php`:\n```php\n$wgGroupPermissions['*']['edit'] = false;\n```\n\n\n## Customization\n\nIt's easy to make the theme look however desired,\nand there are several methods on achieving results.\n\n\n### Basic Bootstrap customization\n\nBootstrap has a customization page\nwhere you can change several aspects of the Bootstrap theme.\nSimply:\n\n1. Visit [the Bootstrap customizer page](http://getbootstrap.com/2.3.2/customize.html)\n2. change values\n3. click the giant button at the bottom of the page\n4. replace Strapping's `bootstrap` directory with the one in your ZIP file\n\nNote: Since Bootstrap is based on the LESS CSS preprocessor,\nyou can also achieve similar results from a command line.\n\n\n### Bootswatch\n\n[Bootswatch](http://bootswatch.com/) is a project\nthat provides drop-in Bootstrap CSS replacements.\n\nVisit the site and grab a theme to start using it immediately.\n\n\n### theme.css\n\nThis method can be used without any other customizations,\nor in addition to altering Bootstrap themes.\n\n1. In the `screen.css` file, uncomment the `theme.css` import.\n2. Add custom CSS to the `theme.css` file,\n   including any colors and fonts you'd like to use.\n\n\n#### Font sources\n\nCustom fonts can be found on [Google Web Fonts](http://google.com/webfonts)\nand you can make your own `@font-face`-ready fonts\n(if you have the permission to do so)\nwith [FontSquirrel's generator](http://fontsquirrel.com/fontface/generator)\n\n\n## Markup reference\n\nWhile plain vanilla MediaWiki markup can be used,\nsites using Strapping can also utilize any of Bootstrap's CSS\nfor more advanced layout and markup.\n\n\n### Strapping-specific\n\nThere are a few Strapping-specific CSS classes you can use.\n\n  **FIXME: Elaborate on strapping-specific CSS classes here**\n\n\n### Layout\n\nDo **NOT** use tables for layout.\nInstead, use Bootstrap's scaffolding to do layout. \n\nBootstrap scaffolding is based on having rows\nthat are formed with 12 possible columns.\nTo span a column, you use a classname of `span`\nplus the number of columns you'd like to span,\nsuch as `span2` to use up 2 columns.\nEverything should add up to 12\n(or less, if there's going to be space on the right side).\n\nMake sure to wrap the spans into `row`s for everything to work correctly.\n\nIt looks something like this:\n\n```html\n  \u003cdiv class=\"row\"\u003e\n    \u003cdiv class=\"span6\"\u003e\u003c/div\u003e\n    \u003cdiv class=\"span6\"\u003e\u003c/div\u003e\n  \u003c/div\u003e\n  \u003cdiv class=\"row\"\u003e\n    \u003cdiv class=\"span6 offset2\"\u003e\u003c/div\u003e\n    \u003cdiv class=\"span3\"\u003e\u003c/div\u003e\n    \u003cdiv class=\"span1\"\u003e\u003c/div\u003e\n  \u003c/div\u003e\n```\n\nFor more information,\nplease visit [Bootstrap's documentation](http://getbootstrap.com/2.3.2/scaffolding.html).\n\n\n### Documentation\n\nPlease consult [MediaWiki's formatting page](http://www.mediawiki.org/wiki/Help:Formatting)\nfor help with writing wiki text.\n\nIf you're feeling adventurous and want to use some more advanced formatting,\nyou can attach any Bootstrap classes to `div`s.\n\n\n### Licensing, Copying, Usage\n\nStrapping is open source, and built on open source projects.\n\nPlease check out the [LICENSE file](https://github.com/OSAS/strapping-mediawiki/blob/master/LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOSAS%2Fstrapping-mediawiki","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FOSAS%2Fstrapping-mediawiki","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOSAS%2Fstrapping-mediawiki/lists"}