YunoHost-Apps/lionwiki-t2t_ynh
1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/lionwiki-t2t_ynh.git synced 2024-09-03 19:36:27 +02:00
Code Issues Activity Actions

maj readme

Browse source 
+ fix dépendance exterieure
This commit is contained in:
farvardin 2020-04-06 11:45:16 +02:00
parent be46836589
commit 7ea1e6fc3b
5 changed files with 110 additions and 91 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

96
README.md
View file

@ -3,16 +3,6 @@
# Lionwiki-t2t for YunoHost # Lionwiki-t2t for YunoHost
## Todo: to package it correctly: https://yunohost.org/#/packaging_apps_fr
# Usage of this package
# Example app for YunoHost
[![Integration level](https://dash.yunohost.org/integration/REPLACEBYYOURAPP.svg)](https://dash.yunohost.org/appci/app/REPLACEBYYOURAPP)
[![Install REPLACEBYYOURAPP with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=REPLACEBYYOURAPP)
*[Lire ce readme en français.](./README_fr.md)* *[Lire ce readme en français.](./README_fr.md)*
@ -20,68 +10,86 @@
If you don't have YunoHost, please see [here](https://yunohost.org/#/install) to know how to install and enjoy it.* If you don't have YunoHost, please see [here](https://yunohost.org/#/install) to know how to install and enjoy it.*
## Overview ## Overview
Quick description of this app.
**Shipped version:** 1.0 LionWiki is a minimalist Wiki engine programmed in PHP. It is extensible, templatable, file based (it doesn't need database like MySQL) and requires just one file to function (30 kb). It is suitable for small websites, personal notebooks or journals. This version is using the lightweight markup language TXT2TAGS.
## Screenshots
![](Link to an screenshot for this app) ## Screenshot
## Demo ![](screenshot_lionwikit2t.png)
* [Official demo](Link to a demo site for this app)
## Configuration ## Configuration
How to configure this app: by an admin panel, a plain file with SSH, or any other way. In the root folder of this app, there are two files: config.php and config.t2t for changing password and general behavior.
## Documentation ## Documentation
* Official documentation: Link to the official documentation of this app * Official documentation: https://github.com/farvardin/lionwiki-t2t
* YunoHost documentation: If specific documentation is needed, feel free to contribute. * More about txt2tags: https://github.com/farvardin/whatistxt2tags
## YunoHost specific features ## YunoHost specific features
#### Multi-users support #### Multi-users support
Are LDAP and HTTP auth supported? This is only a single password for editing the wiki (it's not multi-user), and one other password for administration. Both are set to the same one defined in the lionwiki-t2t during the installation by YunoHost.
Can the app be used by multiple users?
You can set the wiki to private (only readable when you are connected to YunoHost SSO) or public (readable by the whole internet).
You can install multiple instance of this app.
#### Supported architectures #### Supported architectures
* x86-64b - [![Build Status](https://ci-apps.yunohost.org/ci/logs/REPLACEBYYOURAPP%20%28Apps%29.svg)](https://ci-apps.yunohost.org/ci/apps/REPLACEBYYOURAPP/) * All. It's only using PHP.
* ARMv8-A - [![Build Status](https://ci-apps-arm.yunohost.org/ci/logs/REPLACEBYYOURAPP%20%28Apps%29.svg)](https://ci-apps-arm.yunohost.org/ci/apps/REPLACEBYYOURAPP/)
## Limitations ## Limitations
* Any known limitations. * No different user accounts. Configuration only by ssh.
## Additional information ## Additional information
* Other information you would add about this application You must define a base color during the installation (in hexadecimal format). You can choose it using this online tool for example: https://www.w3schools.com/colors/colors_picker.asp
It will modify the templates/minimaxing/minimaxing.less file and compile it using the lessc command (from the node-less package).
After the installation, you can edit the base color found in /var/www/lionwikit2t/templates/minimaxing/minimaxing.less file.
Search for:
```
/* For YunoHost config */
@MainColor: #D17732;
```
Go inside your installation folder (adapt it to your case, if it's the second instance you've installed, it will be named /var/www/lionwikit2t__2/):
```
cd /var/www/lionwikit2t
```
Then compile it with:
```
lessc templates/minimaxing/minimaxing.less > templates/minimaxing/minimaxing.css
```
If something goes wrong, you can go back to the original default file:
```
cp templates/minimaxing/minimaxing_org.css templates/minimaxing/minimaxing.css
```
**More information on the documentation page:**
https://yunohost.org/packaging_apps
## Links ## Links
* Report a bug: https://github.com/YunoHost-Apps/REPLACEBYYOURAPP_ynh/issues * Report a bug: https://github.com/farvardin/lionwiki-t2t_ynh/issues
* App website: Link to the official website of this app * App website: https://github.com/farvardin/lionwiki-t2t
* Upstream app repository: Link to the official repository of the upstream app
* YunoHost website: https://yunohost.org/ * YunoHost website: https://yunohost.org/
---
Developers info
----------------
**Only if you want to use a testing branch for coding, instead of merging directly into master.**
Please do your pull request to the [testing branch](https://github.com/YunoHost-Apps/REPLACEBYYOURAPP_ynh/tree/testing).
To try the testing branch, please proceed like that.
```
sudo yunohost app install https://github.com/YunoHost-Apps/REPLACEBYYOURAPP_ynh/tree/testing --debug
or
sudo yunohost app upgrade REPLACEBYYOURAPP -u https://github.com/YunoHost-Apps/REPLACEBYYOURAPP_ynh/tree/testing --debug
```

87
README_fr.md
View file

@ -1,77 +1,88 @@
# App exemple pour YunoHost
[![Niveau d'intégration](https://dash.yunohost.org/integration/REPLACEBYYOURAPP.svg)](https://dash.yunohost.org/appci/app/REPLACEBYYOURAPP)
[![Installer REPLACEBYYOURAPP avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=REPLACEBYYOURAPP) # Lionwiki-t2t pour YunoHost
*[Read this readme in english.](./README.md)* *[Read this readme in english.](./README.md)*
> *Ce package vous permet d'installer REPLACEBYYOURAPP rapidement et simplement sur un serveur Yunohost. > *Ce package vous permet d'installer Lionwiki-t2t rapidement et simplement sur un serveur Yunohost.
Si vous n'avez pas YunoHost, regardez [ici](https://yunohost.org/#/install) pour savoir comment l'installer et en profiter.* Si vous n'avez pas YunoHost, regardez [ici](https://yunohost.org/#/install) pour savoir comment l'installer et en profiter.*
## Vue d'ensemble ## Vue d'ensemble
Description rapide de cette application.
**Version incluse:** 1.0 Lionwiki-t2t est un système de type wiki minimaliste, programmé en PHP. Il est extensible et n'utilise que des fichiers plats pour sa base de données. Il est adapté pour la création de petits sites web, de notes personnelles ou de journaux. Cette version utilise le langage de balisage léger TXT2TAGS.
## Captures d'écran
![](Lien vers une capture d'écran pour cette application) ## Capture d'écran
## Démo ![](screenshot_lionwikit2t.png)
* [Démo officielle](Lien vers un site de démonstration pour cette application)
## Configuration ## Configuration
Comment configurer cette application: via le panneau d'administration, un fichier brut en SSH ou tout autre moyen. Dans le dossier racine de l'application il y a 2 fichiers, config.php et config.t2t qui permettent de modifier le mot de passe et le comportement général.
## Documentation ## Documentation
* Documentation officielle: Lien vers la documentation officielle de cette application * Documentation officielle: https://github.com/farvardin/lionwiki-t2t
* Documentation YunoHost: Si une documentation spécifique est nécessaire, n'hésitez pas à contribuer. * À propos de txt2tags: https://github.com/farvardin/whatistxt2tags
## Caractéristiques spécifiques YunoHost ## Caractéristiques spécifiques YunoHost
#### Support multi-utilisateurs #### Support multi-utilisateurs
L'authentification LDAP et HTTP est-elle prise en charge? Il y a un seul mot de passe pour éditer ce wiki (dans le fichier config.php), et un autre pour l'administration. C'est le même qui a a été créé lors de l'installation par YunoHost.
L'application peut-elle être utilisée par plusieurs utilisateurs?
Vous pouvez passer le wiki en mode privé ou public, selon vos usages.
#### Architectures supportées #### Architectures supportées
* x86-64b - [![Build Status](https://ci-apps.yunohost.org/ci/logs/REPLACEBYYOURAPP%20%28Apps%29.svg)](https://ci-apps.yunohost.org/ci/apps/REPLACEBYYOURAPP/) * Toutes, cela utilise PHP.
* ARMv8-A - [![Build Status](https://ci-apps-arm.yunohost.org/ci/logs/REPLACEBYYOURAPP%20%28Apps%29.svg)](https://ci-apps-arm.yunohost.org/ci/apps/REPLACEBYYOURAPP/)
* Jessie x86-64b - [![Build Status](https://ci-stretch.nohost.me/ci/logs/REPLACEBYYOURAPP%20%28Apps%29.svg)](https://ci-stretch.nohost.me/ci/apps/REPLACEBYYOURAPP/)
## Limitations ## Limitations
* Limitations connues. * Un seul compte utilisateur. Configuration seulement par fichier éditable en ssh.
## Informations additionnelles ## Informations additionnelles
* Autres informations à ajouter sur cette application Vous devez définir une couleur de base durant l'installation, au format hexadécimal. Vous pouvez la choisir en utilisant cet outil en ligne : https://www.w3schools.com/colors/colors_picker.asp
La couleur choisie va modifier le fichier templates/minimaxing/minimaxing.less et le compiler en utilisant la commande lessc (du paquet node-less).
Après l'installation, vous pouvez éditer la couleur de base dans le fichier /var/www/lionwikit2t/templates/minimaxing/minimaxing.less
Recherchez pour :
```
/* For YunoHost config */
@MainColor: #D17732;
```
Allez dans le dossier d'installation (à adapter à votre cas, si c'est la seconde instance installée, cela sera nommé /var/www/lionwikit2t__2/):
```
cd /var/www/lionwikit2t
```
Ensuite compilez le fichier avec :
```
lessc templates/minimaxing/minimaxing.less > templates/minimaxing/minimaxing.css
```
Si quelque chose se passe mal, vous pouvez revenir au fichier original :
```
cp templates/minimaxing/minimaxing_org.css templates/minimaxing/minimaxing.css
```
**Plus d'informations sur la page de documentation:**
https://yunohost.org/packaging_apps
## Liens ## Liens
* Signaler un bug: https://github.com/YunoHost-Apps/REPLACEBYYOURAPP_ynh/issues * Signaler un bug: https://github.com/farvardin/lionwiki-t2t_ynh/issues
* Site de l'application: Lien vers le site officiel de cette application * Site de l'application: https://github.com/farvardin/lionwiki-t2t
* Dépôt de l'application principale: Lien vers le dépôt officiel de l'application principale
* Site web YunoHost: https://yunohost.org/ * Site web YunoHost: https://yunohost.org/
---
Informations pour les développeurs
----------------
**Seulement si vous voulez utiliser une branche de test pour le codage, au lieu de fusionner directement dans la banche principale.**
Merci de faire vos pull request sur la [branche testing](https://github.com/YunoHost-Apps/REPLACEBYYOURAPP_ynh/tree/testing).
Pour essayer la branche testing, procédez comme suit.
```
sudo yunohost app install https://github.com/YunoHost-Apps/REPLACEBYYOURAPP_ynh/tree/testing --debug
ou
sudo yunohost app upgrade REPLACEBYYOURAPP -u https://github.com/YunoHost-Apps/REPLACEBYYOURAPP_ynh/tree/testing --debug
```

8
conf/minimaxing.less
View file

@ -45,10 +45,10 @@ You can create your own manuscript / handwriting font on http://www.myscriptfont
/* if you prefer to select a fixed background color, just uncomment one color from below */ /* if you prefer to select a fixed background color, just uncomment one color from below */
/* @MainColor: #549136; */ /* @MainColor: #549136; */
/*@MainColor: #7E2434;*/ /* @MainColor: #7E2434; */
@MainColor: #7e3821; /* @MainColor: #7e3821; */
/*@MainColor: #549136;*/ /* @MainColor: #549136; */
@MainColor: #549136; /* @MainColor: #549136; */
/* For YunoHost config */ /* For YunoHost config */
@MainColor: #__YNH_COLOR__; @MainColor: #__YNH_COLOR__;

6
manifest.json
View file

@ -38,8 +38,8 @@
"en": "Choose a path for lionwiki-t2t", "en": "Choose a path for lionwiki-t2t",
"fr": "Choisissez un chemin pour lionwiki-t2t" "fr": "Choisissez un chemin pour lionwiki-t2t"
}, },
"example": "/lionwiki-t2t", "example": "/lionwiki",
"default": "/lionwiki-t2t" "default": "/lionwiki"
}, },
{ {
"name": "admin", "name": "admin",
@ -106,7 +106,7 @@
"en": "Use hexadecimal value (6 figures without #)", "en": "Use hexadecimal value (6 figures without #)",
"fr": "Utilisez une valeur hexadecimale (6 chiffres sans # devant)" "fr": "Utilisez une valeur hexadecimale (6 chiffres sans # devant)"
}, },
"example": "D07732" "example": "D17732"
} }
] ]
} }

4
scripts/install
View file

@ -113,7 +113,7 @@ ynh_app_setting_set --app=$app --key=port --value=$port
### - As well as the section "REINSTALL DEPENDENCIES" in the restore script ### - As well as the section "REINSTALL DEPENDENCIES" in the restore script
### - And the section "UPGRADE DEPENDENCIES" in the upgrade script ### - And the section "UPGRADE DEPENDENCIES" in the upgrade script
#ynh_install_app_dependencies $pkg_dependencies ynh_install_app_dependencies $pkg_dependencies
#================================================= #=================================================
# CREATE A MYSQL DATABASE # CREATE A MYSQL DATABASE
@ -183,7 +183,7 @@ ynh_add_fpm_config
cp ../conf/config.php $final_path/ cp ../conf/config.php $final_path/
cp ../conf/minimaxing.less $final_path/templates/minimaxing/ cp ../conf/minimaxing.less $final_path/templates/minimaxing/
#cp ../conf/minimaxing.css $final_path/templates/minimaxing/ cp ../conf/minimaxing.css $final_path/templates/minimaxing/minimaxing_org.css
# we already use the default html template # we already use the default html template
#cp ../conf/minimaxing.html $final_path/templates/ #cp ../conf/minimaxing.html $final_path/templates/