mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
Misc tweaks to fix deadlinks etc...
This commit is contained in:
Alexandre Aubin
parent
7564ad4d82
commit
ad0be738c9
18 changed files with 99 additions and 225 deletions
|
|
@ -1,32 +0,0 @@
|
|||
---
|
||||
title: الدليل
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
routes:
|
||||
default: '/docs'
|
||||
visible: false
|
||||
---
|
||||
|
||||
دليل واي يونوهوست YunoHost يرتكز أساسًا على ثلاثة محاور :
|
||||
|
||||
[[fa=fa-lock /] دليل المدير](/administrate?classes=btn,btn-lg,btn-primary)
|
||||
يتطرق إلى طريقة التنصيب و إدارة السيرفر و التطبيقات
|
||||
|
||||
[[fa=fa-heart /] دليل المساهم](/contribute?classes=btn,btn-lg,btn-error)
|
||||
يحتوي على كافة المعلومات التي تخصنا و أسلوب عملنا و مساهمتنا
|
||||
|
||||
* Project's life:
|
||||
* [Frequently asked questions](/help/faq)
|
||||
* [Project news](/news)
|
||||
* [Project organization](/project_organization)
|
||||
* [Project budget](/project_budget)
|
||||
* [Forum](https://forum.yunohost.org)
|
||||
* [Chat rooms](/chat_rooms)
|
||||
* [Communication](/communication)
|
||||
* [Support / Help](/help)
|
||||
* [Sponsors and partners](/sponsors_partners)
|
||||
|
||||
* استخدم مثال:
|
||||
* [YunoHost للمنظمات غير الهادفة للربح](/use_case_non-profit_organisations)
|
||||
* (FR) [YunoHost for CHATONS (A collective of independant, transparent, open, neutral and ethical hosters providing FLOSS-based online services.)](https://wiki.chatons.org/doku.php/yunohost)
|
||||
|
|
@ -1,29 +0,0 @@
|
|||
---
|
||||
title: Documentation
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
routes:
|
||||
default: '/docs'
|
||||
visible: false
|
||||
---
|
||||
|
||||
Die YunoHost Dokumentation ist in 2 Bereiche aufgeteilt:
|
||||
|
||||
[[fa=fa-lock /] Handbuch für Administratoren](/administrate?classes=btn,btn-lg,btn-primary)
|
||||
Befasst sich mit den Installationsschritten und der Verwaltung von Server und Apps.
|
||||
|
||||
[[fa=fa-heart /] Handbuch für Mitwirkende](/contribute?classes=btn,btn-lg,btn-error)
|
||||
Alles, was du über uns und unsere Art zu arbeiten wissen musst.
|
||||
|
||||
* Das Projektleben:
|
||||
* [Häufig gestellte Fragen](/faq)
|
||||
* [Projektorganisation](/project_organization)
|
||||
* [Blog](https://forum.yunohost.org/c/announcement)
|
||||
* [Forum](https://forum.yunohost.org)
|
||||
* [Chaträume](/chat_rooms)
|
||||
* [Kommunikation](/communication)
|
||||
* [Support / Hilfe](/help)
|
||||
|
||||
* Verwenden Sie ein Beispiel:
|
||||
* [YunoHost für gemeinnützige Organisationen](/use_case_non-profit_organisations)
|
||||
|
|
@ -1,29 +0,0 @@
|
|||
---
|
||||
title: Documentazione
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
routes:
|
||||
default: '/docs'
|
||||
visible: false
|
||||
---
|
||||
|
||||
La documentazione di YunoHost ha 2 differenti sezioni:
|
||||
|
||||
[[fa=fa-lock /] Guida di amministrazione](/administrate?classes=btn,btn-lg,btn-primary)
|
||||
Include l'installazione, la gestione del server e delle applicazioni.
|
||||
|
||||
[[fa=fa-heart /] Guida del contributore](/contribute?classes=btn,btn-lg,btn-error)
|
||||
Contiene tutto quello che devi sapere su di noi e su come lavoriamo.
|
||||
|
||||
* Vita del progetto :
|
||||
* [Frequently asked questions](/faq)
|
||||
* [Project organization](/project_organization)
|
||||
* [Blog](https://forum.yunohost.org/c/announcement)
|
||||
* [Forum](https://forum.yunohost.org)
|
||||
* [Chat rooms](/chat_rooms)
|
||||
* [Communication](/communication)
|
||||
* [Supporto / Aiuto](/help)
|
||||
|
||||
* Usa l'esempio :
|
||||
* [YunoHost per le organizzazioni senza scopo di lucro](/use_case_non-profit_organisations)
|
||||
|
|
@ -13,7 +13,7 @@ Here is a non-comprehensive list of internet service providers by country, which
|
|||
|
||||
A "no" may cause problems for using your server or may require you to make additional configuration changes. Status in brackets indicates the default behavior.
|
||||
|
||||
A list of French and Belgian ISPs is available on the [french page](/isp_fr).
|
||||
(For the list of ISP in France/Belgian, check the french version of this page)
|
||||
|
||||
### USA
|
||||
| Service provider | Box (modem/router) | uPnP available | Port 25 openable | [Hairpinning](http://en.wikipedia.org/wiki/Hairpinning) | Customizable reverse DNS | Fix IP |
|
||||
|
|
|
|||
|
|
@ -15,7 +15,7 @@ SSH (à partir de votre réseau local ! ou en utilisant un mode rescure si vous
|
|||
|
||||
## Sur l'interface d'administration web
|
||||
|
||||
1. Connectez-vous à [l’administration web](/admin).
|
||||
1. Connectez-vous à l'interface web d'administration.
|
||||
2. Allez dans la section Outis > Changer le mot de passe d’administration.
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -15,7 +15,7 @@ SSH (from your local network! or using a rescue mode if you're on a VPS...)
|
|||
|
||||
## Using the web administration interface
|
||||
|
||||
First, connect to your [web administration](/admin).
|
||||
First, connect to your web administration.
|
||||
|
||||
Then go to Tools > Change administration password.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,52 +0,0 @@
|
|||
---
|
||||
title: Administrator-Dokumentation
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
routes:
|
||||
default: '/admindoc'
|
||||
---
|
||||
|
||||
* Self-Hosting entdecken
|
||||
* [Was ist Self-Hosting](/selfhosting)
|
||||
* [Was ist YunoHost](/whatsyunohost)
|
||||
* [Probiere YunoHost aus](/try)
|
||||
* [Wie du selber hostest](/howtohostyourself)
|
||||
* [Wähle die Hardware](/hardware)
|
||||
* [Über die Freundlichkeit von Internet-Service-Providern](/isp)
|
||||
* [YunoHost installieren](/install)
|
||||
* [Auf einem normalen Computer](/install_iso)
|
||||
* [Auf einem eigenen oder virtuellen Server](/install_on_vps)
|
||||
* [Auf einem Raspberry Pi](/install_on_raspberry)
|
||||
* [Auf einem ARM-Board](/install_on_arm_board)
|
||||
* [Auf Debian](/install_on_debian)
|
||||
* [Auf VirtualBox](/install_on_virtualbox)
|
||||
* Setup abschließen
|
||||
* [Nach der Installation](/postinstall)
|
||||
* [Port-Forwarding konfigurieren](/isp_box_config)
|
||||
* [DNS-Einträge konfigurieren](/dns_config)
|
||||
* [SSL-Zertifikate installieren](/certificate)
|
||||
* [Diagnostiziere deine Installation](/diagnostic)
|
||||
* YunoHost kennenlernen
|
||||
* [Übersicht über YunoHost](/overview)
|
||||
* [Allgemeine Hinweise und Hilfestellungen](/guidelines)
|
||||
* [Web-Administrations-Interface](/admin)
|
||||
* [SSH](/ssh) and [command-line administration](/commandline)
|
||||
* [Benutzer und SSO (Single-Sign-On)](/users)
|
||||
* [Applikationen](/apps_overview)
|
||||
* [Domains, DNS und Zertifikate](/domains)
|
||||
* [E-Mail](/email)
|
||||
* [XMPP](/XMPP)
|
||||
* [Datensicherung](/backup)
|
||||
* [System-Update](/update) and [apps](/app_update)
|
||||
* [Sicherheit](/security)
|
||||
* Weiteres
|
||||
* [Noho.st / nohost.me / ynh.fr Domain-Namen](/dns_nohost_me)
|
||||
* [Grafischer Dateiaustausch mit deinem Server](/filezilla)
|
||||
* [Passe das Aussehen vom Yunohost-Portal an](/theming)
|
||||
* [Für externen Speicher hinzu](/external_storage)
|
||||
* [Migriere E-Mails zu Yunohost](/email_migration)
|
||||
* [Verstecke Services mit Tor](/torhiddenservice)
|
||||
* Hinweise zur Fehlersuche
|
||||
* [Entsperren von IPs in Fail2Ban](/fail2ban)
|
||||
* [Administrator-Passwort ändern](/change_admin_password)
|
||||
|
|
@ -165,12 +165,44 @@ Les options à désactiver (Off) sont :
|
|||
|
||||
Sauvegarder et nettoyer vos caches (Cloudflare, navigateur...) et le tour est joué.
|
||||
|
||||
## Applications Tiers<a name="AppsTiers" href=""></a>
|
||||
## À propos de Keeweb
|
||||
|
||||
+ [Calendrier](/app_nextcloud_calendar)
|
||||
+ [Contact](/app_nextcloud_contact)
|
||||
+ [KeeWeb](/app_nextcloud_keeweb)
|
||||
+ [Carnet](/app_nextcloud_carnet)
|
||||
L'application Keeweb sur le catalogue de nextcloud - [apps.nextcloud.com/keeweb](https://apps.nextcloud.com/apps/keeweb)
|
||||
|
||||
L'application KeeWeb est un gestionnaire de mots de passe incorporé à Nextcloud. Elle permet par exemple de lire un fichier de type KeePass (*.kdbx*) stocké sur votre instance Nextcloud.
|
||||
|
||||
Mais il arrive parfois que Nextcloud ne laisse pas l'application prendre en charge ces fichiers, ce qui rend alors impossible leur lecture de KeeWeb. Pour remédier à cela,
|
||||
[une solution](https://github.com/jhass/nextcloud-keeweb/blob/master/README.md#mimetype-detection) existe.
|
||||
|
||||
Se rendre dans le répertoire de configuration de Nextcloud :
|
||||
|
||||
```bash
|
||||
cd /var/www/nextcloud/config/
|
||||
```
|
||||
|
||||
S'il n'existe pas, créer le fichier *mimetypemapping.json* dont le propriétaire est l'utilisateur *nextcloud* :
|
||||
|
||||
```bash
|
||||
sudo su nextcloud -c "nano mimetypemapping.json"
|
||||
```
|
||||
|
||||
Puis ajouter dans ce fichier le texte suivent :
|
||||
|
||||
```bash
|
||||
{
|
||||
"kdbx": ["x-application/kdbx"]
|
||||
}
|
||||
```
|
||||
|
||||
Enregistrer le fichier (**CTRL** + **o**) et quitter nano (**CTRL** + **c**).
|
||||
|
||||
Ensuite lancer un scan en tant que root :
|
||||
|
||||
```bash
|
||||
sudo -u nextcloud php /var/www/nextcloud/occ files:scan --all
|
||||
```
|
||||
|
||||
À présent, le problème est corrigé.
|
||||
|
||||
## Quelques liens utiles<a name="liensutiles" href=""></a>
|
||||
|
||||
|
|
|
|||
|
|
@ -165,12 +165,41 @@ The options to disable (Off) are:
|
|||
|
||||
Save and clean your caches (Cloudflare, browser...) and that's it.
|
||||
|
||||
## Third Party Applications <a name="AppsTiers" href=""></a>
|
||||
## About Keeweb
|
||||
|
||||
- [Calendrier](/app_nextcloud_calendar)
|
||||
- [Contact](/app_nextcloud_contact)
|
||||
- [KeeWeb](/app_nextcloud_keeweb)
|
||||
- [Carnet](/app_nextcloud_carnet)
|
||||
The KeeWeb application is a password manager integrated into Nextcloud. For example, it allows you to read a KeePass file (*.kdbx*) stored on your Nextcloud instance.
|
||||
But sometimes Nextcloud does not let the application support these files, which makes it impossible to read them from KeeWeb. To remedy this,
|
||||
[a solution](https://github.com/jhass/nextcloud-keeweb/blob/master/README.md#mimetype-detection) exists.
|
||||
|
||||
Go to the Nextcloud configuration directory:
|
||||
|
||||
```bash
|
||||
cd /var/www/nextcloud/config/
|
||||
```
|
||||
|
||||
If it does not exist, create the *mimetypemapping.json* file whose owner is the user *nextcloud* :
|
||||
|
||||
```bash
|
||||
sudo su nextcloud -c "nano mimetypemapping.json"
|
||||
```
|
||||
|
||||
Then add in this file the following text:
|
||||
|
||||
```bash
|
||||
{
|
||||
"kdbx": ["x-application/kdbx"]
|
||||
}
|
||||
```
|
||||
|
||||
Save the file (**CTRL** + **o**) and exit nano (**CTRL** + **c**).
|
||||
|
||||
Then run a scan by executing next command as root:
|
||||
|
||||
```bash
|
||||
sudo -u nextcloud php /var/www/nextcloud/occ files:scan --all
|
||||
```
|
||||
|
||||
Now the problem is fixed.
|
||||
|
||||
## Useful links <a name="UsefulLinks" href=""></a>
|
||||
|
||||
|
|
|
|||
|
|
@ -7,4 +7,4 @@ routes:
|
|||
default: '/app_pleroma'
|
||||
---
|
||||
|
||||
Unfortunately, this page only exists [in french here](/app_pleroma_fr) for now.
|
||||
Unfortunately, this page only exists in french for now.
|
||||
|
|
|
|||
|
|
@ -5,6 +5,8 @@ taxonomy:
|
|||
category: docs
|
||||
routes:
|
||||
default: '/yunohost_project_organization'
|
||||
aliases:
|
||||
- '/project_organization'
|
||||
---
|
||||
|
||||
! This page is outdated and should be reworked
|
||||
|
|
|
|||
|
|
@ -5,6 +5,8 @@ taxonomy:
|
|||
category: docs
|
||||
routes:
|
||||
default: '/yunohost_project_organization'
|
||||
aliases:
|
||||
- '/project_organization'
|
||||
---
|
||||
|
||||
! This page is outdated and should be reworked
|
||||
|
|
|
|||
5
pages/03.community/11.chatons/chatons.fr.md
Normal file
5
pages/03.community/11.chatons/chatons.fr.md
Normal file
|
|
@ -0,0 +1,5 @@
|
|||
---
|
||||
title: Créer son CHATONS avec YunoHost
|
||||
template: docs
|
||||
redirect: 'https://wiki.chatons.org/doku.php/yunohost'
|
||||
---
|
||||
5
pages/03.community/11.chatons/chatons.md
Normal file
5
pages/03.community/11.chatons/chatons.md
Normal file
|
|
@ -0,0 +1,5 @@
|
|||
---
|
||||
title: Creating a CHATONS with YunoHost
|
||||
template: docs
|
||||
redirect: 'https://wiki.chatons.org/doku.php/yunohost'
|
||||
---
|
||||
|
|
@ -1,17 +0,0 @@
|
|||
returncode=0
|
||||
for FILE in $(ls *.md)
|
||||
do
|
||||
NB_OPENING=$(grep -E "^ *\`\`\` *\w+ *$" $FILE | wc -l)
|
||||
NB_CLOSE=$(grep -E "^ *\`\`\` *$" $FILE | wc -l)
|
||||
if [[ "$NB_OPENING" != "$NB_CLOSE" ]]
|
||||
then
|
||||
echo "There are some mistakes in code block syntax in $FILE ..."
|
||||
returncode=1
|
||||
fi
|
||||
done
|
||||
|
||||
if [[ $returncode == 1 ]]
|
||||
then
|
||||
echo "Make sure that all the code block in the problematic files do specific the language in the opening backticks (for example, \`\`\`bash). Otherwise, rendering in the actual website will be broken because of a bug in markdown parsing lib..."
|
||||
exit 1
|
||||
fi
|
||||
|
|
@ -1,19 +1,17 @@
|
|||
returncode=0
|
||||
|
||||
# Find all markdown links and generate a list of filename.md:N:linktarget (with N the line number)
|
||||
for LINK in $(grep -nr -o -E "\]\(\/?(\w|-)+\)" ./*.md | tr -d ']()/')
|
||||
do
|
||||
PAGE=$(echo $LINK | awk -F: '{print $3}')
|
||||
[ -e "$PAGE.md" ] || echo "This Markdown link looks dead (page doesn't exist in english?) $LINK"
|
||||
[ -e "$PAGE.md" ] || returncode=1
|
||||
done
|
||||
# Parse default routes
|
||||
grep -roh "^ *default: .*" ./pages | awk '{print $2}' | tr -d "'" | sort | uniq > .known_pages
|
||||
|
||||
# Find all HTML/href links and generate a list of filename.md:N:linktarget (with N the line number)
|
||||
for LINK in $(grep -nr -o -E 'href="\/?(\w|-)+\"' ./*.md | sed -E 's@href="/?@@g' | tr -d '"')
|
||||
# Parse aliases
|
||||
grep -rh "^---$" ./pages -B 50 | grep "^ *\- '/" | awk '{print $2}' | tr -d "'" | sort | uniq >> .known_pages
|
||||
|
||||
# Find all markdown links and generate a list of filename.md:N:linktarget (with N the line number)
|
||||
for LINK in $(grep -nr -o -E "\]\(\/?(\w|-)+\)" ./pages)
|
||||
do
|
||||
PAGE=$(echo $LINK | awk -F: '{print $3}')
|
||||
[ -e "$PAGE.md" ] || echo "This HTML link looks dead (page doesn't exist in english?) $LINK"
|
||||
[ -e "$PAGE.md" ] || returncode=1
|
||||
PAGE=$(echo $LINK | awk -F: '{print $3}' | tr -d ']()/')
|
||||
|
||||
grep -qw "$PAGE" ./.known_pages || { echo $LINK; returncode=1; }
|
||||
done
|
||||
|
||||
exit $returncode
|
||||
|
|
|
|||
|
|
@ -1,15 +0,0 @@
|
|||
for FILE in $(ls *.md);
|
||||
do
|
||||
grep -q "Unfortunately, this page only exists" $FILE && continue
|
||||
|
||||
# Replace markdown links with full url ... we only need the relative url
|
||||
sed -i -E 's@\(https://yunohost.org/#/(\w+)\)@(/\1)@g' $FILE
|
||||
|
||||
# Replace (/foo_fr) to (foo)
|
||||
sed -i -E 's@\(\/?((\w|-)+)_(en|fr|es|it|ar|de|oc|ca)\)@(/\1)@g' $FILE
|
||||
|
||||
# Replace href="/foo_fr" to href="foo"
|
||||
sed -i -E 's@href="/?((\w|-)+)_(en|fr|es|it|ar|de|oc|ca)"@href="/\1"@g' $FILE;
|
||||
done
|
||||
|
||||
git checkout project_organization.md project_organization_fr.md
|
||||
|
|
@ -1,25 +0,0 @@
|
|||
|
||||
|
||||
MARKDOWN_TARGETS=$(grep -nr -o -E "\]\(\/?(\w|-)+\)" ./*.md | tr -d ']()/' | awk -F: '{print $3}' | sort | uniq)
|
||||
HTML_TARGETS=$(grep -nr -o -E 'href="\/?(\w|-)+\"' ./*.md | sed -E 's@href="/?@@g' | tr -d '"' | awk -F: '{print $3}' | sort | uniq)
|
||||
|
||||
ALL_TARGETS=$(echo $MARKDOWN_TARGETS $HTML_TARGETS)
|
||||
|
||||
PAGES=$(ls *.md | sed -E 's/(_(fr|it|de|ar|oc|es|ru|ca))?\.md//g' | sort | uniq)
|
||||
|
||||
returncode=0
|
||||
|
||||
for PAGE in $PAGES
|
||||
do
|
||||
if [[ $PAGE == "index" ]] || [[ $PAGE == "README" ]] || [[ $PAGE == "default" ]]
|
||||
then
|
||||
continue
|
||||
fi
|
||||
if ! echo $ALL_TARGETS | grep -q -w $PAGE
|
||||
then
|
||||
returncode=1
|
||||
echo "The following page is not referenced by any other page :( -> $PAGE"
|
||||
fi
|
||||
done
|
||||
|
||||
exit $returncode
|
||||
Loading…
Reference in a new issue