Calculate Wiki, le manuel

Updated 17 Mai 2018

Ici vous êtes sur le tout nouveau Calculate Linux Wiki. Tout le monde peut contribuer !

Pourquoi avons-nous créé Calculate Wiki ?

Notre objectif principal était de permettre aux utilisateurs de Calculate Linux de contribuer au projet, à savoir (co)travailler sur la documentation CL. Nous suggérons que tous les auteurs respectent plusieurs règles, pour que vos articles soient faciles à lire et à comprendre. N'ayez pas peur de faire quelque chose que vous ne devriez pas avoir : n'importe quel article sur Calculate Wiki peut être édité à nouveau.

Astuce

Consultez les articles existants pour vous faire une idée sur la façon d'écrire votre propre article.

Langage de balisage que nous utilisons

D'après les résultats de[ce sondage] (https://vk.com/calculatelinux?w=wall-10221243_12230), le nouveau site utilise le langage Markdown. Il a été présenté juste avant[le lancement] (https://www.calculate-linux.ru/blogs/en/679/show) du projet Calculate Wiki. Merci à Sergey, qui a suggéré de passer à Markdown dans une discussion[@calculate_wiki] (https://t.me/calculate_wiki), et à tous ceux qui ont participé au sondage ! Nous aimions beaucoup Textile, mais il était temps que nous passions à une majoration encore plus pratique. Pour lire le manuel de balisage, cliquez sur le point d'interrogation sur le panneau supérieur ou vérifiez un article existant.

Comment soumettre des articles et des modifications

  1. Pour créer un nouvel article, sélectionnezNouvel article dans le menu du site.
  2. Lorsqu'un article est sauvegardé, il va dans[Bac à sable] (sandbox) et attend modération et approbation. Tous les articles qui n'ont pas été modérés seront surlignés en jaune dans la liste principale, et seront disponibles pour édition et navigation pour tous les utilisateurs enregistrés du site. Ils ne peuvent cependant pas être consultés par des visiteurs non autorisés du site.
  3. Lorsqu'un article est édité par des utilisateurs réguliers, toutes les modifications doivent être approuvées pour être validées. Essayez d'expliquer vos modifications avec précision chaque fois que vous en suggérez. Le texte affiché par défaut est soit celui dont les modifications ont été approuvées, soit, en l'absence d'approbation, la version la plus récente. Pour accéder aux modifications récentes, allez à l'ébauche ou au point d'historique le plus récent. Les modifications non approuvées seront surlignées en jaune dans l'historique des modifications.
  4. Tous les utilisateurs ont accès à la gestion des points de l'historique des articles et peuvent revenir à une version antérieure.

Règles

Vous devez être absolument sûr de ce que vous dites dans votre article ou manuel. Ne faites pas d'hypothèses. Écrivez au présent. Préférez les affirmations aux négations.

Exemple

Installation, Est utilisé ou Installer, Utiliser.

Votre article ou manuel doit être complet, afin de fournir des informations complètes et claires sur le sujet. S'en tenir à l'approche "Quoi - Où - Où - Comment". Vérifiez les articles existants avant de créer le vôtre. Si le sujet qui vous intéresse existe déjà, vous pouvez toujours soumettre vos commentaires ou modifications.

Conventions

  • Nom de domaine : calculate.local
  • Numérotation du réseau: 192.168.0.0, additional 192.168.1-9.0
  • Connexions utilisateur: user, additional user(1-20)
  • {12faf9c5d6a436cceb6c4ea2baec7d83

Règles d'ajout de code

**NotePar défaut, toutes les commandes sont censées être exécutées à partir de root. Si une commande doit être exécutée avec des privilèges utilisateur, vous devez le spécifier dans votre manuel !

Commande unique:

emerge -av chromium

Commande avec sortie:

# rc-update add postgresql-9.6 default
 * service postgresql-9.6 added to runlevel default

Note Si la commande n'est pas affichée en entier, une ellipse remplace la fin du code.

Exécuter les commandes à tour de rôle

# cd /var/www/nextcloud
# wget https://download.nextcloud.com/server/releases/nextcloud-12.0.3.zip

Si vous utilisez un code simple avec des guillemets simples, vous devez ajouter du code en utilisant des guillemets triples.

Exemple:

MariаDB [(none)]> CREATE DATABASE `base` CHARACTER SET utf8 COLLATE utf8_general_ci;

Vous devez utiliser la syntaxe du code que vous voulez publier.

Voici quelques exemples de syntaxes les plus utilisées.

  • Code PHP:
<?php
/*
 * Generated configuration file
 * Generated by: phpMyAdmin 4.7.5 setup script
 * Date: Sat, 18 Nov 2017 15:51:14 +0000
 */
/* Servers configuration */
$i = 0;
/* Server: localhost [1] */
$i++;
$cfg['Servers'][$i]['verbose'] = '';
$cfg['Servers'][$i]['host'] = 'localhost';
$cfg['Servers'][$i]['port'] = '';
...
  • Code Nginx:
# pmalempcss.calculate.loc
server {
        listen 80;
        server_name pmalempcss.calculate.local;
        access_log /var/www/pma/logs/pma.access_log main;
        error_log /var/www/pma/logs/pma.error_log info;
        root /var/www/pma/htdocs/;
        index index.php index.html index.htm;
        location ~ \.php$ {
               try_files $uri =404;
               include /etc/nginx/fastcgi.conf;
               fastcgi_pass unix:/run/php-fpm.socket;
           }
}
  • Code du fichier de configuration:
...
;PHP был установлен неверно. Запрос getenv("PATH") возвращает пустые результаты.
env[HOSTNAME] = $HOSTNAME
env[PATH] = /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/opt/bin
env[TMP] = /tmp
env[TMPDIR] = /tmp
env[TEMP] = /tmp
  • Sortie Bash:
# psql -U nextcloud -d nextcloud -h 127.0.0.1 -W
Пароль пользователя nextcloud:
psql (9.6.6)
Введите "help", чтобы получить справку.
nextcloud-> \q

Niveaux d'accès utilisateur

Vous n'avez pas besoin d'authentification pour lire le Wiki de Calculate. Si vous voulez contribuer, utilisez vos identifiants sur calculate-linux.org pour vous connecter. Il y a plusieurs niveaux d'accès dans le wiki de Calculate, indiqués par une icône de chiffre d'échecs à côté du nom d'utilisateur : pion, alfin, cavalier et reine correspondent respectivement à l'utilisateur, éditeur, modérateur et administrateur.

utilisateur éditeur modérateur administrateur
Enregistrer dans l'Environnement de test + + + +
Déplacer l'article de l'Environnement de test + +
Modifications du journal + + + +
Accepter le projet de modification dans son propre article + + + +
Accepter le projet de modification dans l'article de quelqu'un d'autre + + +
Modifier l'en-tête d'un article + +
Modifier le lien de la page + +
Ajouter breadcrumbs + +
Déplacer l'article dans l'Environnement de test + +
Bloquer l'utilisateur + +
Supprimer un article +
  • Le niveau User est le niveau d'accès de base, attribué à chaque utilisateur enregistré. Un Utilisateur est autorisé à créer de nouveaux articles qui seront ensuite vérifiés et approuvés par un Modérateur ; à éditer les articles d'autres personnes, à valider ou non par un Editeur ou un Modérateur. Une fois que l'article écrit par un Utilisateur a été approuvé, il ou elle pourra soit approuver les modifications proposées par d'autres utilisateurs, soit revenir au point précédent de l'historique. Lorsque dix articles rédigés par un utilisateur ont été approuvés, il ou elle devient un éditeur.

  • Le niveau Editeur permet d'éditer ses propres articles et ceux d'autres personnes sans modération préalable. Lors de la création d'un nouvel article, un éditeur doit attendre l'approbation d'un modérateur.

  • Le niveau Modérateur accorde les mêmes droits, à l'exception qu'un modérateur est autorisé à approuver les modifications et les articles écrits par d'autres utilisateurs, à créer et modifier des articles avec une hiérarchie, ainsi qu'à interdire des utilisateurs si nécessaire.

Si vous avez des questions ou des suggestions, contactez-nous surTelegram.