77 lines
2.4 KiB
Markdown
77 lines
2.4 KiB
Markdown
## Install
|
|
|
|
1. Make sure to comment out `- ./LocalSettings.php:/var/www/html/LocalSettings.php` in `docker-compose.yaml` and run `docker-compose up --build -d`. An error will be raised if you use an existing `LocalSettings.php`.
|
|
(Oct 2024 update: There was a breaking change in Docker image version `1.39`, so we may need to use version `1.38` or earlier in `docker-compose.yaml` to run this repository)
|
|
|
|
2. Visit `http://localhost:8080/`
|
|
|
|
3. Click `Please set up the wiki first.` and select a language
|
|
|
|
4. Continue
|
|
|
|
5. Set up database
|
|
|
|
```
|
|
Database host: database (must be the same as the container name of mariadb)
|
|
|
|
Database name: (must be the same as MYSQL_DATABASE of docker-compose.yaml)
|
|
|
|
Database username: (must be the same as MYSQL_USER of docker-compose.yaml)
|
|
|
|
Database password: (must be the same as MYSQL_PASSWORD of docker-compose.yaml)
|
|
```
|
|
|
|
6. Continue
|
|
|
|
7. Set up wiki admin account and select `I'm bored already, just install the wiki.` if a detailed configuration is not needed.
|
|
|
|
8. Continue
|
|
|
|
9. `LocalSettings.php` will be downloaded automatically.
|
|
|
|
10. Stop all the containers with `docker-compose down` and Put `LocalSettings.php` in the root directory of the repo.
|
|
|
|
11. (Important) Change `$wgDefaultSkin = "vector";` to `$wgDefaultSkin = "vector-2022";` in `LocalSettings.php`
|
|
|
|
12. (Optional) Add the following lines below `$wgDefaultSkin` in order to display errors in your browser, if any. This will help you enable error display and debugging features for your MediaWiki installation.
|
|
|
|
```
|
|
error_reporting( -1 );
|
|
ini_set( 'display_errors', 1 );
|
|
|
|
$wgShowExceptionDetails = true;
|
|
$wgShowDBErrorBacktrace = true;
|
|
```
|
|
|
|
13. (Important) Uncomment `- ./LocalSettings.php:/var/www/html/LocalSettings.php` in `docker-compose.yaml` to apply the configuration in `LocalSettings.php`
|
|
|
|
14. run `docker-compose up --build -d` again.
|
|
|
|
15. Sign in with the admin account
|
|
|
|
|
|
## Check files in docker containers
|
|
|
|
```
|
|
docker exec -it --user=root {container id from docker ps} bash
|
|
|
|
e.g.,
|
|
docker exec -it --user=root 24a696c42c95 bash
|
|
```
|
|
|
|
## Customizing CSS
|
|
|
|
Vector/resources/common/variable.less
|
|
|
|
- Change the hex code of @background-color-secondary
|
|
|
|
## MediaWiki References
|
|
|
|
- [Github](https://github.com/wikimedia/mediawiki)
|
|
|
|
- [Manual:How to make a MediaWiki skin](https://www.mediawiki.org/wiki/Manual:How_to_make_a_MediaWiki_skin)
|
|
|
|
- [Custom pages](https://github.com/wikimedia/mediawiki/tree/master/includes/specialpage)
|
|
|
|
- [Object Factory](https://www.mediawiki.org/wiki/ObjectFactory)
|