logos-wiki/README.md

2.4 KiB

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)
  1. Continue

  2. Set up wiki admin account and select I'm bored already, just install the wiki. if a detailed configuration is not needed.

  3. Continue

  4. LocalSettings.php will be downloaded automatically.

  5. Stop all the containers with docker-compose down and Put LocalSettings.php in the root directory of the repo.

  6. (Important) Change $wgDefaultSkin = "vector"; to $wgDefaultSkin = "vector-2022"; in LocalSettings.php

  7. (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;
  1. (Important) Uncomment - ./LocalSettings.php:/var/www/html/LocalSettings.php in docker-compose.yaml to apply the configuration in LocalSettings.php

  2. run docker-compose up --build -d again.

  3. 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