doc: update installation instructions for Rails 8 and Debian Trixie

- Target Debian Trixie (stable)
- Update MySQL/MariaDB package names
- Simplify Bundler installation (now included with Ruby)
- Improve document structure and add syntax highlighting

Author: echarp

INSTALL.md

@@ -1,51 +1,44 @@
-# Introduction
+# LinuxFr.org installation
+
+## Introduction
 
 This document will give you steps to install LinuxFr.org website on your
-Debian Stretch development machine.
+Debian Trixie (stable) development machine.
 
 Note that all commands which require root access are prefixed by `sudo`.
 
-# Install Debian packages
+## Install Debian packages
 
-Packages to install from main Stretch source:
+Packages to install from main Debian source:
 
-```
-~ $ sudo apt install mysql-server mysql-client libmysql++-dev git \
-build-essential openssl libreadline-dev curl libcurl4-openssl-dev zlib1g \
-zlib1g-dev libssl-dev libxml2-dev libxslt-dev autoconf libgmp-dev libyaml-dev \
-ncurses-dev bison automake libtool imagemagick libc6-dev hunspell \
-hunspell-fr-comprehensive redis-server ruby ruby-dev ruby-rack
+```sh
+~ $ sudo apt install default-mysql-server default-libmysqlclient-dev \
+libmysql++-dev git build-essential openssl libreadline-dev curl \
+libcurl4-openssl-dev zlib1g zlib1g-dev libssl-dev libxml2-dev libxslt-dev \
+autoconf libgmp-dev libyaml-dev ncurses-dev bison automake libtool \
+imagemagick libc6-dev hunspell hunspell-fr-comprehensive redis-server \
+ruby ruby-dev
 ```
 
 Note:
-  * you can use libcurl4-gnutls-dev instead of libcurl4-openssl-dev.
-  * the `mysql` packages will install MariaDB on Debian Stretch
 
-# Get LinuxFr.org code and external resources
+- you can use libcurl4-gnutls-dev instead of libcurl4-openssl-dev.
+- the `default-mysql-server` package will install MariaDB on Debian
+
+## Get LinuxFr.org code and external resources
 
 Use git to get LinuxFr.org sources:
 
-```
+```sh
 ~ $ git clone git://github.com/linuxfrorg/linuxfr.org.git
 ```
 
 To be able to reach ruby external resources, you need the `bundler` packager.
-The minimal required version is written at the end of the `Gemfile.lock` file.
-Actually, Debian has the `1.13.6` version and the lock file requires already
-the `1.16.4` version.
-
-So we first install the `bundler` packager directly from `rubygems.org`:
-
-```
-~ $ gem install --user-install bundler
-```
-
-Don't forget to update your PATH environment according to the warning message
-shown during installation.
+It is now installed by default with Ruby.
 
 Now, we can reach external Ruby resources:
 
-```
+```sh
 ~ $ cd linuxfr.org
 ~/linuxfr.org $ bundle config set path 'vendor/bundle'
 ~/linuxfr.org $ bundle install
@@ -61,11 +54,11 @@ the collaborative `redaction` space to work asynchronously.
 
 To install it, the simplest is to run `gem install --user-install board-linuxfr`
 
-# Configure LinuxFr.org
+## Configure LinuxFr.org
 
 To configure LinuxFr.org, you need to copy both sample configuration files:
 
-```
+```sh
 ~/linuxfr.org $ cp config/database.yml{.sample,}
 ~/linuxfr.org $ cp config/secrets.yml{.sample,}
 ```
@@ -80,17 +73,17 @@ In this document we'll assume you took the default values for database names:
 Note that, on production, you'll need to customize secrets inside
 the `secrets.yml` file.
 
-# Configure SQL data base
+## Configure SQL data base
 
 Prepare time zones information inside the `mysql` database:
 
-```
+```sh
 ~ $ mysql_tzinfo_to_sql /usr/share/zoneinfo | sudo mysql mysql
 ```
 
 Create LinuxFr.org databases and MySQL users:
 
-```
+```sql
 ~/linuxfr.org $ sudo mysql
 > CREATE DATABASE linuxfr_rails CHARACTER SET utf8mb4;
 > CREATE USER linuxfr_rails IDENTIFIED BY 'linuxfr_rails password';
@@ -106,15 +99,15 @@ Create LinuxFr.org databases and MySQL users:
 Now every thing is ready and we can ask `rails` to setup our databases with
 every structures needed:
 
-```
+```sh
 ~/linuxfr.org $ bin/rails db:setup
 ```
 
-# Run LinuxFr.org
+## Run LinuxFr.org
 
 Now, you can run LinuxFr.org server with:
 
-```
+```sh
 ~/linuxfr.org $ bin/rails server
 ```
 
@@ -123,23 +116,23 @@ virtual machine using the `http://localhost:3000` URL.
 
 Additionally, you run the boards within another terminal:
 
-```
+```sh
 ~/linuxfr.org $ board-linuxfr -s -a localhost -p 9000
 ```
 
-# Configure redirection
+## Configure redirection
 
 This extra step isn't really needed to be able to use LinuxFr.org.
 
 In the `config/environments/development.rb` file, there are these variables:
 
 1. `MY_DOMAIN` and `IMG_DOMAIN` which define the domain name for the LinuxFr
-    service and the image caching service.
-    By default both domain names are `dlfp.lo`.
+   service and the image caching service.
+   By default both domain names are `dlfp.lo`.
 
 2. `MY_PUBLIC_URL` and `IMG_PUBLIC_PORT` which define the public HTTP port for
-    both services.
-    By default both ports are `80`.
+   both services.
+   By default both ports are `80`.
 
 These two set of variables are used to build the public url of the two
 services. By default both public urls are `http://dlfp.lo`.
@@ -150,13 +143,13 @@ install a website locally using this domain name.
 
 Set the domain `dlfp.lo` to target `localhost`:
 
-```
+```sh
 ~ $ sudo bash -c 'echo "127.0.0.1 dlfp.lo" >> /etc/hosts'
 ```
 
 For Nginx, create a new server configuration with content like:
 
-```
+```nginx
 server {
     server_name dlfp.lo;
     access_log /var/log/nginx/dlfp.access.log;
@@ -169,7 +162,7 @@ server {
 
     # Avatars files uploaded on linuxfr server are stored in partitions
     # with folder name containing 3 digits
-    location ~ ^/avatars/\d\d\d/ { 
+    location ~ ^/avatars/\d\d\d/ {
       root /home/linuxfr/linuxfr.org/uploads;
     }
 
@@ -203,14 +196,14 @@ server {
 
 and restart the web server:
 
-```
+```sh
 ~ $ sudo systemctl restart nginx
 ```
 
 Now, on the virtual machine, you can access LinuxFr.org with the
 `http://dlfp.lo` URL.
 
-# Create administrator
+## Create administrator
 
 To create new users, you can use directly the website.
 
@@ -219,7 +212,7 @@ in the database.
 
 For example, to set as admin the user with login `admin_login`:
 
-```
+```sql
 $ sudo mysql linuxfr_rails
 > update accounts set role = 'admin' where login = 'admin_login' ;
 ```