|
|
- ---
- date: "2017-08-23T09:00:00+02:00"
- title: "Documentation"
- slug: "documentation"
- url: "/fr-fr/"
- weight: 10
- toc: true
- draft: false
- ---
-
- # A propos de Gitea
-
- Gitea est un service Git auto-hébergé très simple à installer et à utiliser. Il est similaire à GitHub, Bitbucket ou Gitlab. Le développement initial provient sur [Gogs] (http://gogs.io), mais nous l'avons forké puis renommé Gitea. Si vous souhaitez en savoir plus sur les raisons pour lesquelles nous avons fait cela, lisez [cette publication] (https://blog.gitea.io/2016/12/welcome-to-gitea/) sur le blog.
-
- ## Objectif
-
- Le but de ce projet est de fournir de la manière la plus simple, la plus rapide et sans complication un service Git auto-hébergé. Grâce à Go, cela peut se faire via un binaire indépendant fonctionnant sur toutes les plateformes que Go prend en charge, y compris Linux, macOS et Windows, même sur des architectures comme ARM ou PowerPC.
-
- ## Fonctionalités
-
- - Tableau de bord de l'utilisateur
- - Choix du contexte (organisation ou utilisateur actuel)
- - Chronologie de l'activité
- - Révisions (_Commits_)
- - Tickets
- - Demande d'ajout (_Pull request_)
- - Création de dépôts
- - Liste des dépôts
- - Liste de vos organisations
- - Liste des dépôts miroires
- - Tableau de bord des tickets
- - Choix du contexte (organisation ou utilisateur actuel)
- - Filtres
- - Ouvert
- - Fermé
- - Vos dépôts
- - Tickets assignés
- - Vos tickets
- - Dépôts
- - Options de tri
- - Plus vieux
- - Dernière mise à jour
- - Nombre de commentaires
- - Tableau de bord des demandes d'ajout
- - Identique au tableau de bord des tickets
- - Types de dépôt
- - Miroire
- - Normal
- - Migré
- - Notifications (courriel et web)
- - Lu
- - Non lu
- - Épinglé
- - Page d'exploration
- - Utilisateurs
- - Dépôts
- - Organisations
- - Moteur de recherche
- - Interface personnalisables
- - Fichiers publiques remplaçables (logo, css, etc)
- - Protection CSRF et XSS
- - Support d'HTTPS
- - Configuration des types et de la taille maximale des fichiers téléversés
- - Journalisation (_Log_)
- - Configuration
- - Base de données
- - MySQL
- - PostgreSQL
- - SQLite3
- - MSSQL
- - [TiDB](https://github.com/pingcap/tidb) (expérimental)
- - Fichier de configuration
- - Voir [ici](https://github.com/go-gitea/gitea/blob/master/custom/conf/app.ini.sample)
- - Panel d'administration
- - Statistiques
- - Actions
- - Suppression des comptes inactifs
- - Suppression des dépôts archivés
- - Suppression des dépôts pour lesquels il manque leurs fichiers
- - Exécution du _garbage collector_ sur les dépôts
- - Ré-écriture des clefs SSH
- - Resynchronisation des hooks
- - Recreation des dépôts manquants
- - Status du server
- - Temps de disponibilité
- - Mémoire
- - Nombre de goroutines
- - et bien plus...
- - Gestion des utilisateurs
- - Recherche
- - Tri
- - Dernière connexion
- - Méthode d'authentification
- - Nombre maximum de dépôts
- - Désactivation du compte
- - Permissions d'administration
- - Permission pour crééer des hooks
- - Permission pour crééer des organisations
- - Permission pour importer des dépôts
- - Gestion des organisations
- - Membres
- - Équipes
- - Avatar
- - Hooks
- - Gestion des depôts
- - Voir toutes les informations pour un dépôt donné et gérer tous les dépôts
- - Méthodes d'authentification
- - OAuth
- - PAM
- - LDAP
- - SMTP
- - Visualisation de la configuration
- - Tout ce que contient le fichier de configuration
- - Alertes du système
- - Quand quelque chose d'inattendu survient
- - Surveillance
- - Processus courrants
- - Tâches CRON
- - Mise à jour des dépôts miroires
- - Vérification de l'état des dépôts
- - Vérification des statistiques des dépôts
- - Nettoyage des anciennes archives
- - Variables d'environement
- - Options de ligne de commande
- - Internationalisation ([21 langues](https://github.com/go-gitea/gitea/tree/master/options/locale))
- - Courriel
- - Notifications
- - Confirmation d'inscription
- - Ré-initialisation du mot de passe
- - Support de _reverse proxy_
- - _subpaths_ inclus
- - Utilisateurs
- - Profil
- - Nom
- - Prénom
- - Courriel
- - Site internet
- - Date de création
- - Abonnés et abonnements
- - Organisations
- - Dépôts
- - Activité
- - Dépôts suivis
- - Paramètres
- - Identiques au profil avec en plus les éléments ci-dessous
- - Rendre l'adresse de courriel privée
- - Avatar
- - Gravatar
- - Libravatar
- - Personnalisé
- - Mot de passe
- - Courriels multiples
- - Clefs SSH
- - Applications connectées
- - Authentification à double facteurs
- - Identités OAuth2 attachées
- - Suppression du compte
- - Dépôts
- - Clone à partir de SSH / HTTP / HTTPS
- - Git LFS
- - Suivre, Voter, Fork
- - Voir les personnes qui suivent, les votes et les forks
- - Code
- - Navigation entre les branches
- - Création ou téléversement de fichier depuis le navigateur
- - URLs pour clôner le dépôt
- - Téléchargement
- - ZIP
- - TAR.GZ
- - Édition en ligne
- - Éditeur Markdown
- - Éditeur de texte
- - Coloration syntaxique
- - Visualisation des Diffs
- - Visualisation
- - Possibilité de choisir où sauvegarder la révision
- - Historiques des fichiers
- - Suppression de fichiers
- - Voir le fichier brut
- - Tickets
- - Modèle de ticket
- - Jalons
- - Étiquettes
- - Affecter des tickets
- - Filtres
- - Ouvert
- - Ferme
- - Personne assignée
- - Créer par vous
- - Qui vous mentionne
- - Tri
- - Plus vieux
- - Dernière mise à jour
- - Nombre de commentaires
- - Moteur de recherche
- - Commentaires
- - Joindre des fichiers
- - Demande d’ajout (_Pull request_)
- - Les mêmes fonctionnalités que pour les tickets
- - Révisions (_Commits_)
- - Representation graphique des révisions
- - Révisions par branches
- - Moteur de recherche
- - Voir les différences
- - Voir les numéro de révision SHA
- - Voir l'auteur
- - Naviguer dans les fichiers d'une révision donnée
- - Publication
- - Pièces jointes
- - Titre
- - Contenu
- - Suppression
- - Définir comme une pré-publication
- - Choix de la branche
- - Wiki
- - Import
- - Éditeur Markdown
- - Paramètres
- - Options
- - Nom
- - Description
- - Privé / Publique
- - Site internet
- - Wiki
- - Activé / Désactivé
- - Interne / externe
- - Tickets
- - Activé / Désactivé
- - Interne / externe
- - URL personnalisable pour une meilleur intégration avec un gestionnaire de tickets externe
- - Activer / désactiver les demandes d'ajout (_Pull request_)
- - Transfert du dépôt
- - Suppression du wiki
- - Suppression du dépôt
- - Collaboration
- - Lecture / Écriture / Administration
- - Branches
- - Branche par défaut
- - Protection
- - Webhooks
- - Git hooks
- - Clefs de déploiement
-
- ## Configuration requise
-
- - Un simple Raspberry Pi est assez puissant pour les fonctionnalités de base.
- - Un processeur double coeurs et 1Gb de RAM est une bonne base pour une utilisation en équipe.
- - Gitea est censé être exécuté avec un compte utilisateur dédié et non root, aucun autre mode de fonctionnement n'est pris en charge. (**NOTE**: Dans le cas où vous l'exécutez avec votre propre compte d'utilisateur et que le serveur SSH intégré est désactivé, Gitea modifie le fichier `~ /.ssh /authorized_keys` afin que vous ne soyez **plus capable** de vous connecter interactivement).
-
- ## Navigateurs supportés
-
- - Consultez [Semantic UI](https://github.com/Semantic-Org/Semantic-UI#browser-support) pour la liste des navigateurs supportés.
- - La taille minimale supportée officielement est de **1024*768**, l'interface utilisateur peut toujours fonctionner à une taille plus petite, mais ce n'est pas garanti et les problèmes remontés ne seront pas corrigés.
-
- ## Composants
-
- * Framework web : [Macaron](http://go-macaron.com/)
- * ORM : [XORM](https://github.com/go-xorm/xorm)
- * Interface graphique :
- * [Semantic UI](http://semantic-ui.com/)
- * [GitHub Octicons](https://octicons.github.com/)
- * [Font Awesome](http://fontawesome.io/)
- * [DropzoneJS](http://www.dropzonejs.com/)
- * [Highlight](https://highlightjs.org/)
- * [Clipboard](https://zenorocha.github.io/clipboard.js/)
- * [Emojify](https://github.com/Ranks/emojify.js)
- * [CodeMirror](https://codemirror.net/)
- * [jQuery Date Time Picker](https://github.com/xdan/datetimepicker)
- * [jQuery MiniColors](https://github.com/claviska/jquery-minicolors)
- * Connecteurs de base de données :
- * [github.com/go-sql-driver/mysql](https://github.com/go-sql-driver/mysql)
- * [github.com/lib/pq](https://github.com/lib/pq)
- * [github.com/mattn/go-sqlite3](https://github.com/mattn/go-sqlite3)
- * [github.com/pingcap/tidb](https://github.com/pingcap/tidb)
- * [github.com/denisenkom/go-mssqldb](https://github.com/denisenkom/go-mssqldb)
-
- ## Logiciels et services
-
- - [Drone](https://github.com/drone/drone) (Intégration continue)
|
