docs: use generic example.com domain in samples and docs
This commit is contained in:
+20
-20
@@ -42,8 +42,8 @@ Cette application est un *fork* de https://labola.o-k-i.net/ORGANISATION-KA-INTE
|
|||||||
| Dépôt de ce fork
|
| Dépôt de ce fork
|
||||||
| `git@labola.o-k-i.net:cedric/annu-kute-ced.git`
|
| `git@labola.o-k-i.net:cedric/annu-kute-ced.git`
|
||||||
|
|
||||||
| Domaine de production
|
| Domaine (exemple)
|
||||||
| https://annukuteced.buzz
|
| https://example.com
|
||||||
|
|
||||||
| Gouvernance
|
| Gouvernance
|
||||||
| Application maintenue par OKI ; fork porté par le propriétaire du dépôt *cedric* (Cédric Famibelle-Pronzola)
|
| Application maintenue par OKI ; fork porté par le propriétaire du dépôt *cedric* (Cédric Famibelle-Pronzola)
|
||||||
@@ -267,7 +267,7 @@ cp dons.php.sample dons.php
|
|||||||
. 🛡️ Installez la configuration serveur sécurisée depuis `conf/` (voir <<fr-securite,Sécurité>>).
|
. 🛡️ Installez la configuration serveur sécurisée depuis `conf/` (voir <<fr-securite,Sécurité>>).
|
||||||
. ✍️ Rendez le dossier `cache/` accessible en écriture par le serveur web (créé automatiquement au premier appel API).
|
. ✍️ Rendez le dossier `cache/` accessible en écriture par le serveur web (créé automatiquement au premier appel API).
|
||||||
. 🔒 Assurez-vous que HTTPS est actif (obligatoire pour la PWA).
|
. 🔒 Assurez-vous que HTTPS est actif (obligatoire pour la PWA).
|
||||||
. 🌐 Faites pointer votre domaine (`annukuteced.buzz`) vers la racine du projet.
|
. 🌐 Faites pointer votre domaine (ex. `example.com`) vers la racine du projet.
|
||||||
|
|
||||||
[[fr-configuration]]
|
[[fr-configuration]]
|
||||||
=== ⚙️ Configuration
|
=== ⚙️ Configuration
|
||||||
@@ -308,7 +308,7 @@ Valeurs par défaut issues de `includes/config.default.php`.
|
|||||||
| Constante | Défaut | Description
|
| Constante | Défaut | Description
|
||||||
|
|
||||||
| `APP_HOST_NAME`
|
| `APP_HOST_NAME`
|
||||||
| `'annukuteced.buzz'`
|
| `'example.com'`
|
||||||
| Nom de domaine affiché (mentions légales…)
|
| Nom de domaine affiché (mentions légales…)
|
||||||
|
|
||||||
| `ORGANIZATION_SHORT_NAME`
|
| `ORGANIZATION_SHORT_NAME`
|
||||||
@@ -707,7 +707,7 @@ NOTE: Le cache de l'API PeerTube et de WordPress (`includes/simple-cache.php`) e
|
|||||||
[source,php]
|
[source,php]
|
||||||
----
|
----
|
||||||
<?php
|
<?php
|
||||||
define('APP_HOST_NAME', 'annukuteced.buzz');
|
define('APP_HOST_NAME', 'example.com');
|
||||||
|
|
||||||
// PeerTube (chaîne GADE du podcast)
|
// PeerTube (chaîne GADE du podcast)
|
||||||
define('PEERTUBE_URL', 'https://gade.o-k-i.net');
|
define('PEERTUBE_URL', 'https://gade.o-k-i.net');
|
||||||
@@ -744,7 +744,7 @@ define('CACHE_DURATION', 3600);
|
|||||||
|
|
||||||
==== Fichiers d'instance à personnaliser
|
==== Fichiers d'instance à personnaliser
|
||||||
|
|
||||||
Les fichiers `sitemap.xml`, `robots.txt`, `site.webmanifest`, `mentions-legales.php` et `dons.php` sont ignorés par Git : copiez les `.sample` puis adaptez-les. Les exemples fournis sont *pré-remplis pour `annukuteced.buzz`* ; pour un autre domaine, remplacez simplement les occurrences du domaine. Dans `mentions-legales.php`, remplacez aussi le placeholder `VOTRE-DATE-MAJ`.
|
Les fichiers `sitemap.xml`, `robots.txt`, `site.webmanifest`, `mentions-legales.php` et `dons.php` sont ignorés par Git : copiez les `.sample` puis adaptez-les. Les exemples fournis utilisent le domaine générique `example.com` : remplacez-le par votre domaine réel. Dans `mentions-legales.php`, remplacez aussi le placeholder `VOTRE-DATE-MAJ`.
|
||||||
|
|
||||||
=== 🧭 Ordre des sections sur la page d'accueil
|
=== 🧭 Ordre des sections sur la page d'accueil
|
||||||
|
|
||||||
@@ -793,8 +793,8 @@ WARNING: Cette configuration est *essentielle* : sans elle, vos fichiers de conf
|
|||||||
[source,bash]
|
[source,bash]
|
||||||
----
|
----
|
||||||
# Adaptez les chemins dans conf/nginx.conf.sample puis :
|
# Adaptez les chemins dans conf/nginx.conf.sample puis :
|
||||||
sudo cp conf/nginx.conf.sample /etc/nginx/sites-available/annukuteced.buzz
|
sudo cp conf/nginx.conf.sample /etc/nginx/sites-available/example.com
|
||||||
sudo ln -s /etc/nginx/sites-available/annukuteced.buzz /etc/nginx/sites-enabled/
|
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
|
||||||
sudo nginx -t && sudo systemctl reload nginx
|
sudo nginx -t && sudo systemctl reload nginx
|
||||||
----
|
----
|
||||||
|
|
||||||
@@ -843,7 +843,7 @@ WARNING: Pour que la détection fonctionne, `sw.js` ne doit *pas* être caché l
|
|||||||
|
|
||||||
==== Installation par les visiteurs
|
==== Installation par les visiteurs
|
||||||
|
|
||||||
- 🌐 *Chrome/Edge* : menu → « Installer annukuteced.buzz »
|
- 🌐 *Chrome/Edge* : menu → « Installer example.com »
|
||||||
- 🍎 *Safari iOS* : Partager → « Ajouter à l'écran d'accueil »
|
- 🍎 *Safari iOS* : Partager → « Ajouter à l'écran d'accueil »
|
||||||
- 🦊 *Firefox Android* : menu → « Installer »
|
- 🦊 *Firefox Android* : menu → « Installer »
|
||||||
|
|
||||||
@@ -867,7 +867,7 @@ Données alors collectées (anonymes) : pages visitées, pays d'origine (IP non
|
|||||||
. 🔧 Permissions : `644` pour les fichiers, `755` pour les dossiers ; `cache/` accessible en écriture
|
. 🔧 Permissions : `644` pour les fichiers, `755` pour les dossiers ; `cache/` accessible en écriture
|
||||||
. 📄 Créez les fichiers d'instance depuis les `.sample` (config, manifest, robots, sitemap, mentions légales, dons)
|
. 📄 Créez les fichiers d'instance depuis les `.sample` (config, manifest, robots, sitemap, mentions légales, dons)
|
||||||
. 🛡️ Copiez `conf/.htaccess.sample` en `.htaccess` (Apache)
|
. 🛡️ Copiez `conf/.htaccess.sample` en `.htaccess` (Apache)
|
||||||
. 🌐 Faites pointer le domaine `annukuteced.buzz` vers le dossier d'installation
|
. 🌐 Faites pointer votre domaine (ex. `example.com`) vers le dossier d'installation
|
||||||
. 🧪 Testez la PWA via les outils de développement du navigateur (onglet Application)
|
. 🧪 Testez la PWA via les outils de développement du navigateur (onglet Application)
|
||||||
|
|
||||||
=== 👨💻 Développement et contribution
|
=== 👨💻 Développement et contribution
|
||||||
@@ -946,8 +946,8 @@ This application is a *fork* of https://labola.o-k-i.net/ORGANISATION-KA-INTERNA
|
|||||||
| This fork's repository
|
| This fork's repository
|
||||||
| `git@labola.o-k-i.net:cedric/annu-kute-ced.git`
|
| `git@labola.o-k-i.net:cedric/annu-kute-ced.git`
|
||||||
|
|
||||||
| Production domain
|
| Domain (example)
|
||||||
| https://annukuteced.buzz
|
| https://example.com
|
||||||
|
|
||||||
| Governance
|
| Governance
|
||||||
| Application maintained by OKI; fork carried by the repository owner *cedric* (Cédric Famibelle-Pronzola)
|
| Application maintained by OKI; fork carried by the repository owner *cedric* (Cédric Famibelle-Pronzola)
|
||||||
@@ -1171,7 +1171,7 @@ cp dons.php.sample dons.php
|
|||||||
. 🛡️ Install the hardened server configuration from `conf/` (see <<en-securite,Security>>).
|
. 🛡️ Install the hardened server configuration from `conf/` (see <<en-securite,Security>>).
|
||||||
. ✍️ Make the `cache/` directory writable by the web server (created automatically on the first API call).
|
. ✍️ Make the `cache/` directory writable by the web server (created automatically on the first API call).
|
||||||
. 🔒 Make sure HTTPS is enabled (mandatory for the PWA).
|
. 🔒 Make sure HTTPS is enabled (mandatory for the PWA).
|
||||||
. 🌐 Point your domain (`annukuteced.buzz`) to the project root.
|
. 🌐 Point your domain (e.g. `example.com`) to the project root.
|
||||||
|
|
||||||
[[en-configuration]]
|
[[en-configuration]]
|
||||||
=== ⚙️ Configuration
|
=== ⚙️ Configuration
|
||||||
@@ -1212,7 +1212,7 @@ Default values from `includes/config.default.php`.
|
|||||||
| Constant | Default | Description
|
| Constant | Default | Description
|
||||||
|
|
||||||
| `APP_HOST_NAME`
|
| `APP_HOST_NAME`
|
||||||
| `'annukuteced.buzz'`
|
| `'example.com'`
|
||||||
| Displayed domain name (legal notice…)
|
| Displayed domain name (legal notice…)
|
||||||
|
|
||||||
| `ORGANIZATION_SHORT_NAME`
|
| `ORGANIZATION_SHORT_NAME`
|
||||||
@@ -1611,7 +1611,7 @@ NOTE: The PeerTube API and WordPress cache (`includes/simple-cache.php`) is *alw
|
|||||||
[source,php]
|
[source,php]
|
||||||
----
|
----
|
||||||
<?php
|
<?php
|
||||||
define('APP_HOST_NAME', 'annukuteced.buzz');
|
define('APP_HOST_NAME', 'example.com');
|
||||||
|
|
||||||
// PeerTube (the podcast's GADE channel)
|
// PeerTube (the podcast's GADE channel)
|
||||||
define('PEERTUBE_URL', 'https://gade.o-k-i.net');
|
define('PEERTUBE_URL', 'https://gade.o-k-i.net');
|
||||||
@@ -1648,7 +1648,7 @@ define('CACHE_DURATION', 3600);
|
|||||||
|
|
||||||
==== Instance files to customize
|
==== Instance files to customize
|
||||||
|
|
||||||
The `sitemap.xml`, `robots.txt`, `site.webmanifest`, `mentions-legales.php` and `dons.php` files are Git-ignored: copy the `.sample` files then adapt them. The provided samples are *pre-filled for `annukuteced.buzz`*; for another domain, simply replace the domain occurrences. In `mentions-legales.php`, also replace the `VOTRE-DATE-MAJ` placeholder.
|
The `sitemap.xml`, `robots.txt`, `site.webmanifest`, `mentions-legales.php` and `dons.php` files are Git-ignored: copy the `.sample` files then adapt them. The provided samples use the generic `example.com` domain: replace it with your real domain. In `mentions-legales.php`, also replace the `VOTRE-DATE-MAJ` placeholder.
|
||||||
|
|
||||||
=== 🧭 Homepage section order
|
=== 🧭 Homepage section order
|
||||||
|
|
||||||
@@ -1697,8 +1697,8 @@ WARNING: This configuration is *essential*: without it, your configuration files
|
|||||||
[source,bash]
|
[source,bash]
|
||||||
----
|
----
|
||||||
# Adjust the paths in conf/nginx.conf.sample, then:
|
# Adjust the paths in conf/nginx.conf.sample, then:
|
||||||
sudo cp conf/nginx.conf.sample /etc/nginx/sites-available/annukuteced.buzz
|
sudo cp conf/nginx.conf.sample /etc/nginx/sites-available/example.com
|
||||||
sudo ln -s /etc/nginx/sites-available/annukuteced.buzz /etc/nginx/sites-enabled/
|
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
|
||||||
sudo nginx -t && sudo systemctl reload nginx
|
sudo nginx -t && sudo systemctl reload nginx
|
||||||
----
|
----
|
||||||
|
|
||||||
@@ -1747,7 +1747,7 @@ WARNING: For detection to work, `sw.js` must *not* be cached for long by the ser
|
|||||||
|
|
||||||
==== Installation by visitors
|
==== Installation by visitors
|
||||||
|
|
||||||
- 🌐 *Chrome/Edge*: menu → "Install annukuteced.buzz"
|
- 🌐 *Chrome/Edge*: menu → "Install example.com"
|
||||||
- 🍎 *Safari iOS*: Share → "Add to Home Screen"
|
- 🍎 *Safari iOS*: Share → "Add to Home Screen"
|
||||||
- 🦊 *Firefox Android*: menu → "Install"
|
- 🦊 *Firefox Android*: menu → "Install"
|
||||||
|
|
||||||
@@ -1771,7 +1771,7 @@ Data then collected (anonymous): visited pages, country of origin (IP not stored
|
|||||||
. 🔧 Permissions: `644` for files, `755` for directories; `cache/` must be writable
|
. 🔧 Permissions: `644` for files, `755` for directories; `cache/` must be writable
|
||||||
. 📄 Create the instance files from the `.sample` files (config, manifest, robots, sitemap, legal notice, donations)
|
. 📄 Create the instance files from the `.sample` files (config, manifest, robots, sitemap, legal notice, donations)
|
||||||
. 🛡️ Copy `conf/.htaccess.sample` to `.htaccess` (Apache)
|
. 🛡️ Copy `conf/.htaccess.sample` to `.htaccess` (Apache)
|
||||||
. 🌐 Point the `annukuteced.buzz` domain to the installation directory
|
. 🌐 Point your domain (e.g. `example.com`) to the installation directory
|
||||||
. 🧪 Test the PWA via the browser developer tools (Application tab)
|
. 🧪 Test the PWA via the browser developer tools (Application tab)
|
||||||
|
|
||||||
=== 👨💻 Development and contributing
|
=== 👨💻 Development and contributing
|
||||||
|
|||||||
@@ -7,7 +7,7 @@
|
|||||||
* Il est utilisé pour initialiser les variables non définies dans config.local.php.
|
* Il est utilisé pour initialiser les variables non définies dans config.local.php.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
if (!defined('APP_HOST_NAME')) define('APP_HOST_NAME', 'annukuteced.buzz');
|
if (!defined('APP_HOST_NAME')) define('APP_HOST_NAME', 'example.com');
|
||||||
|
|
||||||
if (!defined('ORGANIZATION_SHORT_NAME')) define('ORGANIZATION_SHORT_NAME', 'ANNU KUTE CED');
|
if (!defined('ORGANIZATION_SHORT_NAME')) define('ORGANIZATION_SHORT_NAME', 'ANNU KUTE CED');
|
||||||
if (!defined('ORGANIZATION_NAME')) define('ORGANIZATION_NAME', 'ANNU KUTE CED');
|
if (!defined('ORGANIZATION_NAME')) define('ORGANIZATION_NAME', 'ANNU KUTE CED');
|
||||||
|
|||||||
@@ -10,7 +10,7 @@
|
|||||||
* Note: config.local.php ne doit pas être versionné dans git
|
* Note: config.local.php ne doit pas être versionné dans git
|
||||||
*/
|
*/
|
||||||
|
|
||||||
define('APP_HOST_NAME', 'annukuteced.buzz');
|
define('APP_HOST_NAME', 'example.com');
|
||||||
|
|
||||||
// define('ORGANIZATION_SHORT_NAME', 'ANNU KUTE CED');
|
// define('ORGANIZATION_SHORT_NAME', 'ANNU KUTE CED');
|
||||||
// define('ORGANIZATION_NAME', 'ANNU KUTE CED');
|
// define('ORGANIZATION_NAME', 'ANNU KUTE CED');
|
||||||
|
|||||||
+1
-1
@@ -22,4 +22,4 @@ Disallow: /conf/
|
|||||||
Disallow: /cache/
|
Disallow: /cache/
|
||||||
|
|
||||||
# Sitemap
|
# Sitemap
|
||||||
Sitemap: https://annukuteced.buzz/sitemap.xml
|
Sitemap: https://example.com/sitemap.xml
|
||||||
|
|||||||
+13
-13
@@ -1,67 +1,67 @@
|
|||||||
<?xml version="1.0" encoding="UTF-8"?>
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
|
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
|
||||||
<url>
|
<url>
|
||||||
<loc>https://annukuteced.buzz/</loc>
|
<loc>https://example.com/</loc>
|
||||||
<changefreq>daily</changefreq>
|
<changefreq>daily</changefreq>
|
||||||
<priority>1.0</priority>
|
<priority>1.0</priority>
|
||||||
</url>
|
</url>
|
||||||
<url>
|
<url>
|
||||||
<loc>https://annukuteced.buzz/index</loc>
|
<loc>https://example.com/index</loc>
|
||||||
<changefreq>daily</changefreq>
|
<changefreq>daily</changefreq>
|
||||||
<priority>1.0</priority>
|
<priority>1.0</priority>
|
||||||
</url>
|
</url>
|
||||||
<url>
|
<url>
|
||||||
<loc>https://annukuteced.buzz/index.php</loc>
|
<loc>https://example.com/index.php</loc>
|
||||||
<changefreq>daily</changefreq>
|
<changefreq>daily</changefreq>
|
||||||
<priority>1.0</priority>
|
<priority>1.0</priority>
|
||||||
</url>
|
</url>
|
||||||
<url>
|
<url>
|
||||||
<loc>https://annukuteced.buzz/direct</loc>
|
<loc>https://example.com/direct</loc>
|
||||||
<changefreq>hourly</changefreq>
|
<changefreq>hourly</changefreq>
|
||||||
<priority>0.9</priority>
|
<priority>0.9</priority>
|
||||||
</url>
|
</url>
|
||||||
<url>
|
<url>
|
||||||
<loc>https://annukuteced.buzz/direct.php</loc>
|
<loc>https://example.com/direct.php</loc>
|
||||||
<changefreq>hourly</changefreq>
|
<changefreq>hourly</changefreq>
|
||||||
<priority>0.9</priority>
|
<priority>0.9</priority>
|
||||||
</url>
|
</url>
|
||||||
<url>
|
<url>
|
||||||
<loc>https://annukuteced.buzz/mentions-legales</loc>
|
<loc>https://example.com/mentions-legales</loc>
|
||||||
<changefreq>monthly</changefreq>
|
<changefreq>monthly</changefreq>
|
||||||
<priority>0.3</priority>
|
<priority>0.3</priority>
|
||||||
</url>
|
</url>
|
||||||
<url>
|
<url>
|
||||||
<loc>https://annukuteced.buzz/mentions-legales.php</loc>
|
<loc>https://example.com/mentions-legales.php</loc>
|
||||||
<changefreq>monthly</changefreq>
|
<changefreq>monthly</changefreq>
|
||||||
<priority>0.3</priority>
|
<priority>0.3</priority>
|
||||||
</url>
|
</url>
|
||||||
<url>
|
<url>
|
||||||
<loc>https://annukuteced.buzz/recherche</loc>
|
<loc>https://example.com/recherche</loc>
|
||||||
<changefreq>weekly</changefreq>
|
<changefreq>weekly</changefreq>
|
||||||
<priority>0.8</priority>
|
<priority>0.8</priority>
|
||||||
</url>
|
</url>
|
||||||
<url>
|
<url>
|
||||||
<loc>https://annukuteced.buzz/recherche.php</loc>
|
<loc>https://example.com/recherche.php</loc>
|
||||||
<changefreq>weekly</changefreq>
|
<changefreq>weekly</changefreq>
|
||||||
<priority>0.8</priority>
|
<priority>0.8</priority>
|
||||||
</url>
|
</url>
|
||||||
<url>
|
<url>
|
||||||
<loc>https://annukuteced.buzz/categories</loc>
|
<loc>https://example.com/categories</loc>
|
||||||
<changefreq>weekly</changefreq>
|
<changefreq>weekly</changefreq>
|
||||||
<priority>0.8</priority>
|
<priority>0.8</priority>
|
||||||
</url>
|
</url>
|
||||||
<url>
|
<url>
|
||||||
<loc>https://annukuteced.buzz/categories.php</loc>
|
<loc>https://example.com/categories.php</loc>
|
||||||
<changefreq>weekly</changefreq>
|
<changefreq>weekly</changefreq>
|
||||||
<priority>0.8</priority>
|
<priority>0.8</priority>
|
||||||
</url>
|
</url>
|
||||||
<url>
|
<url>
|
||||||
<loc>https://annukuteced.buzz/video</loc>
|
<loc>https://example.com/video</loc>
|
||||||
<changefreq>weekly</changefreq>
|
<changefreq>weekly</changefreq>
|
||||||
<priority>0.7</priority>
|
<priority>0.7</priority>
|
||||||
</url>
|
</url>
|
||||||
<url>
|
<url>
|
||||||
<loc>https://annukuteced.buzz/video.php</loc>
|
<loc>https://example.com/video.php</loc>
|
||||||
<changefreq>weekly</changefreq>
|
<changefreq>weekly</changefreq>
|
||||||
<priority>0.7</priority>
|
<priority>0.7</priority>
|
||||||
</url>
|
</url>
|
||||||
|
|||||||
Reference in New Issue
Block a user