Pico
2.1.4
Pico est un CMS de fichiers plats bêtement simple et ultra rapide.
Visitez-nous sur http://picocms.org/ et consultez http://picocms.org/about/ pour plus d'informations.
Vous voyez un Unparenthesized a ? b : c ? d : e is not supported. erreur?
Pico a actuellement des problèmes avec les versions PHP ultérieures à 8.0. Cela est dû aux dépendances de Pico, et non à Pico lui-même. Il existe actuellement une version « alpha » de Pico que vous pouvez télécharger en tant que version pré-groupée qui résout ce problème.
Cette "alpha" est parfaitement sûre à utiliser en production, car les seules modifications sont les dépendances mises à jour et les chaînes de numéros de version . Si vous êtes curieux, vous pouvez le confirmer en comparant les changements entre les branches.
Davantage de travail était prévu sur cette branche, d'où le label "3.0", mais cela n'a pas encore été fait. Il y a une discussion en cours sur la fusion de ces dépendances mises à jour en tant que mise à jour officielle (soit Pico 2.2, soit 3.0) dès que possible.
Désolé pour le désagrément occasionné et merci à tous les utilisateurs de Pico pour votre patience à ce sujet.
L'installation de Pico est extrêmement simple - et effectuée en quelques secondes ! Si vous avez accès à un shell sur votre serveur (c'est-à-dire un accès SSH), nous vous recommandons d'utiliser Composer. Sinon, utilisez une version pré-groupée. Si vous ne savez pas ce qu'est « l'accès SSH », rendez-vous sur la version pré-groupée.
Pico nécessite PHP 5.3.6+ et les extensions PHP dom et mbstring pour être activés.
À partir de Pico 2.0, nous vous recommandons d'installer Pico à l'aide de Composer autant que possible. Faites-nous confiance, vous ne le regretterez pas lorsqu'il s'agira de mettre à niveau Pico ! Quoi qu'il en soit, si vous ne souhaitez pas utiliser Composer, ou si vous ne pouvez tout simplement pas utiliser Composer parce que vous n'avez pas accès à un shell sur votre serveur, ne désespérez pas, installer Pico à l'aide d'une version pré-intégrée est toujours plus facile que tout ce que vous savez !
Ouvrez un shell et accédez au répertoire httpdocs (par exemple /var/www/html ) de votre serveur. Téléchargez Composer et exécutez-le avec l'option create-project pour l'installer dans le répertoire souhaité (par exemple /var/www/html/pico ) :
$ curl -sSL https://getcomposer.org/installer | php $ php composer.phar créer-projet picocms/pico-composer pico
Quelle deuxième étape ? Il n'y a pas de deuxième étape. C'est ça! Ouvrez votre navigateur Web préféré et accédez à votre tout nouveau CMS de fichiers plats, stupidement simple et ultra-rapide ! Les exemples de contenu de Pico vous expliqueront comment créer votre propre contenu.
Connaissez-vous le sentiment : vous souhaitez installer un nouveau site Web, vous téléchargez donc tous les fichiers de votre CMS préféré et exécutez le script d'installation - juste pour découvrir que vous avez d'abord oublié de créer la base de données SQL ? Plus tard, le script d'installation vous indique que les autorisations de fichiers sont erronées. Bon sang, qu’est-ce que cela signifie ? Oubliez ça, Pico est différent !
Téléchargez la dernière version de Pico et téléchargez tous les fichiers dans le répertoire d'installation souhaité de Pico dans le répertoire httpdocs (par exemple /var/www/html/pico ) de votre serveur.
D'accord, voici le piège : il n'y a pas de piège. C'est ça! Ouvrez votre navigateur Web préféré et accédez à votre tout nouveau CMS de fichiers plats, stupidement simple et ultra-rapide ! Les exemples de contenu de Pico vous expliqueront comment créer votre propre contenu.
Git est un système de contrôle de version distribué très puissant - et il peut être utilisé pour établir un flux de travail agréable autour de votre site Web Pico. L'utilisation d'un référentiel Git pour votre site Web facilite la création et le déploiement de contenu, y compris l'édition collaborative et le contrôle de version. Si vous souhaitez gérer votre site Web dans un référentiel Git, vous utilisez une installation basée sur Composer.
Forkez le projet de démarrage Composer de Pico à l'aide du bouton fork de GitHub. Si vous ne souhaitez pas utiliser GitHub, vous n'êtes pas obligé de le faire, vous pouvez choisir le serveur Git de votre choix. Le fork manuel ne nécessite que quelques étapes supplémentaires : clonez d'abord le référentiel Git localement, ajoutez votre serveur Git en tant que serveur distant et transférez le référentiel vers ce nouveau référentiel distant.
Clonez votre fork localement et ajoutez votre contenu et vos ressources. Vous pouvez modifier composer.json de Pico pour inclure des plugins et des thèmes tiers, ou simplement ajouter vos propres plugins et thèmes aux plugins de Pico, respectivement. répertoires themes . N'oubliez pas de valider vos modifications et de les transmettre à votre serveur Git.
Ouvrez un shell sur votre serveur Web et accédez au répertoire httpdocs (par exemple /var/www/html ). Téléchargez Composer, clonez votre référentiel Git dans le répertoire souhaité (par exemple /var/www/html/pico ) et installez les dépendances de Pico à l'aide de l'option install de Composer :
$ curl -sSL https://getcomposer.org/installer | php $ git clone https://github.com/<YOUR_USERNAME>/<YOUR_REPOSITORY> pico $ php composer.phar --working-dir=pico install
Si vous mettez à jour le contenu de votre site Web, validez simplement vos modifications et transférez-les sur votre serveur Git. Ouvrez un shell sur votre serveur Web et accédez au répertoire d'installation de Pico dans le répertoire httpdocs (par exemple /var/www/html/pico ) de votre serveur. Extrayez toutes les modifications de votre serveur Git et mettez à jour les dépendances de Pico à l'aide de l'option update de Composer :
$ git pull $ php composer.phar mise à jour
Alors, vous faites partie de ces personnes extraordinaires qui rendent tout cela possible ? Nous vous aimons les amis ! En tant que développeur, nous vous recommandons de cloner le référentiel Git de Pico ainsi que les référentiels Git du thème par défaut de Pico et du plugin PicoDeprecated . Vous pouvez configurer votre espace de travail à l'aide du projet de démarrage Composer de Pico et inclure tous les composants de Pico à l'aide de packages locaux.
L'utilisation des référentiels Git de Pico est différente de l'utilisation de l'une des méthodes d'installation expliquées ci-dessus. Il vous donne la version de développement actuelle de Pico, qui est probablement instable et pas prête pour une utilisation en production !
Ouvrez un shell et accédez au répertoire souhaité de l'espace de travail de développement de Pico dans le répertoire httpdocs (par exemple /var/www/html/pico ) de votre serveur. Téléchargez et extrayez le projet de démarrage Composer de Pico dans le répertoire workspace :
$ curl -sSL https://github.com/picocms/pico-composer/archive/master.tar.gz | tarxz $ mv espace de travail pico-composer-master
Clonez les référentiels Git de tous les composants Pico (le noyau de Pico, le thème par défaut de Pico et le plugin PicoDeprecated ) dans le répertoire components :
$ composants mkdir $ git clone https://github.com/picocms/Pico.git composants/pico $ git clone https://github.com/picocms/pico-theme.git composants/pico-theme $ git clone https://github.com/picocms/pico-deprecated.git composants/pico-deprecated
Demandez à Composer d'utiliser les référentiels Git locaux en remplacement des packages picocms/pico (le noyau de Pico), picocms/pico-theme (le thème par défaut de Pico) et picocms/pico-deprecated (le plugin PicoDeprecated ). Mettez à jour le composer.json de votre espace de travail de développement (c'est-à-dire workspace/composer.json ) en conséquence :
{"dépôts": [
{"type": "chemin", "url": "../components/pico", "options": { "symlink": true }
},
{"type": "chemin", "url": "../components/pico-theme", "options": { "symlink": true }
},
{"type": "chemin", "url": "../components/pico-deprecated", "options": { "symlink": true }
}
],"require": {"picocms/pico": "dev-master","picocms/pico-theme": "dev-master","picocms/pico-deprecated": "dev-master","picocms/ composer-installer": "^1.0"}
} Téléchargez Composer et exécutez-le avec l'option install :
$ curl -sSL https://getcomposer.org/installer | php $ php composer.phar --working-dir=installation de l'espace de travail
Vous pouvez maintenant ouvrir votre navigateur Web et accéder à l'espace de travail de développement de Pico. Toutes les modifications que vous apportez aux composants de Pico seront automatiquement reflétées dans l'espace de travail de développement.
D'ailleurs, vous pouvez également trouver tous les composants de Pico sur Packagist.org : le noyau de Pico, le thème par défaut de Pico, le plugin PicoDeprecated et le projet de démarrage Composer de Pico.
Vous souvenez-vous de la date à laquelle vous avez installé Pico ? C'était ingénieusement simple, n'est-ce pas ? La mise à niveau de Pico ne fait aucune différence ! Le processus de mise à niveau diffère selon que vous avez utilisé Composer ou une version pré-intégrée pour installer Pico. Veuillez noter que vous devez toujours créer une sauvegarde de votre installation Pico avant la mise à niveau !
Pico suit Semantic Versioning 2.0 et utilise des numéros de version comme MAJOR . MINOR . PATCH . Lorsque nous mettons à jour la version PATCH (par exemple 2.0.0 vers 2.0.1 ), nous avons apporté des corrections de bugs rétrocompatibles. Si nous changeons la version MINOR (par exemple 2.0 à 2.1 ), nous avons ajouté des fonctionnalités de manière rétrocompatible. La mise à niveau de Pico est extrêmement simple dans les deux cas. Rendez-vous simplement dans les sections de mise à niveau appropriées ci-dessous.
Mais attendez, nous avons oublié de mentionner ce qui se passe lorsque nous mettons à jour la version MAJOR (par exemple 2.0 vers 3.0 ). Dans ce cas, nous avons apporté des modifications incompatibles à l'API. Nous vous fournirons ensuite un didacticiel de mise à niveau approprié. Veuillez donc vous rendre sur la page « Mise à niveau » de notre site Web.
La mise à niveau de Pico est très simple si vous avez utilisé Composer pour installer Pico. Ouvrez simplement un shell et accédez au répertoire d'installation de Pico dans le répertoire httpdocs (par exemple /var/www/html/pico ) de votre serveur. Vous pouvez désormais mettre à niveau Pico en utilisant une seule commande :
$ php composer.phar mise à jour
C'est ça! Composer mettra automatiquement à jour Pico et tous les plugins et thèmes que vous avez installés à l'aide de Composer. Assurez-vous de mettre à jour manuellement tous les plugins et thèmes que vous avez installés manuellement.
D'accord, l'installation de Pico a été facile, mais la mise à niveau de Pico va être difficile, n'est-ce pas ? J'ai peur de devoir vous décevoir. C'est aussi simple que d'installer Pico !
Vous devrez d'abord supprimer le répertoire vendor de votre installation Pico (par exemple, si vous avez installé Pico sur /var/www/html/pico , supprimez /var/www/html/pico/vendor ). Téléchargez ensuite la dernière version de Pico et téléchargez tous les fichiers dans votre répertoire d'installation Pico existant. Il vous sera demandé si vous souhaitez écraser des fichiers comme index.php , .htaccess , ... - appuyez simplement sur "Oui".
C'est ça! Maintenant que Pico est à jour, vous devez mettre à jour tous les plugins et thèmes que vous avez installés.
En tant que développeur, vous devez savoir comment rester à jour... Par souci d'exhaustivité, si vous souhaitez mettre à niveau Pico, ouvrez simplement un shell et accédez à l'espace de travail de développement de Pico (par exemple /var/www/html/pico ). Ensuite, extrayez les derniers commits des référentiels Git du noyau de Pico, du thème par défaut de Pico et du plugin PicoDeprecated . Laissez Composer mettre à jour vos dépendances et vous êtes prêt à partir.
$ git -C composants/pico pull $ git -C composants/pico-theme pull $ git -C composants/pico-pull obsolète $ php composer.phar --working-dir=mise à jour de l'espace de travail
Si vous souhaitez commencer à utiliser Pico, veuillez vous référer à notre documentation utilisateur. Veuillez lire les notes de mise à niveau si vous souhaitez passer de Pico 1.0 à Pico 2.0. Vous pouvez trouver des plugins et des thèmes officiellement pris en charge sur notre site Web. Un plus grand choix de plugins et de thèmes tiers peut être trouvé dans notre Wiki sur les pages des plugins ou des thèmes respectivement. Si vous souhaitez créer votre propre plugin ou thème, veuillez vous référer à la section « Obtenir de l'aide en tant que développeur » ci-dessous.
Si vous êtes un développeur, veuillez vous référer à la section « Contribuer » ci-dessous et à nos directives de contribution. Pour commencer à créer un plugin ou un thème, veuillez lire la documentation du développeur sur notre site Web.
Lorsque les documents ne peuvent pas répondre à votre question, vous pouvez obtenir de l'aide en nous rejoignant sur #picocms sur Libera.Chat (journaux). Lorsque vous rencontrez des problèmes avec Pico, n'hésitez pas à créer un nouveau problème sur GitHub. Concernant les problèmes avec les plugins ou les thèmes, merci de vous référer au site internet du développeur de ce plugin ou de ce thème.
Avant de créer un nouveau problème, assurez-vous que le problème n'a pas encore été signalé à l'aide du moteur de recherche GitHubs. Veuillez décrire votre problème aussi clairement que possible et inclure toujours la version de Pico que vous utilisez. À condition que vous utilisiez des plugins , incluez-en également une liste. Nous avons besoin d'informations sur le comportement réel et attendu , les étapes pour reproduire le problème et les mesures que vous avez prises pour résoudre le problème par vous-même (c'est-à-dire votre propre dépannage ).
Vous souhaitez contribuer à Pico ? Nous apprécions vraiment cela ! Vous pouvez contribuer à améliorer Pico en contribuant au code ou en signalant des problèmes, mais veuillez prendre note de nos directives de contribution. En général, vous pouvez contribuer dans trois domaines différents :
Plugins et thèmes : Vous êtes développeur de plugins ou concepteur de thèmes ? Nous vous aimons les amis ! Vous pouvez trouver des tonnes d'informations sur la façon de développer des plugins et des thèmes sur http://picocms.org/development/. Si vous avez créé un plugin ou un thème, veuillez l'ajouter à notre Wiki, soit sur la page des plugins, soit sur la page des thèmes. Vous pouvez également le soumettre à notre site Web, où il sera affiché sur les pages officielles du plugin ou du thème !
Documentation : Nous apprécions toujours que les gens améliorent notre documentation. Vous pouvez soit améliorer la documentation utilisateur en ligne, soit la documentation utilisateur plus complète sur notre site Web. Vous pouvez également améliorer la documentation pour les développeurs de plugins et de thèmes. Créez simplement le référentiel Git de notre site Web à partir de https://github.com/picocms/picocms.github.io, modifiez les fichiers Markdown et ouvrez une pull request.
Pico's Core : La discipline suprême est de travailler sur Pico's Core. Votre contribution devrait aider chaque utilisateur de Pico à avoir une meilleure expérience avec Pico. Si tel est le cas, forkez Pico depuis https://github.com/picocms/Pico et ouvrez une pull request. Nous attendons votre contribution avec impatience !
En contribuant à Pico, vous acceptez et acceptez le certificat d'origine du développeur pour vos contributions présentes et futures soumises à Pico. Veuillez vous référer à la section « Certificat d'origine du développeur » dans notre CONTRIBUTING.md .
Vous n'avez pas le temps de contribuer au code de Pico, mais vous souhaitez quand même « offrir un café » à ceux qui le font ? Vous pouvez contribuer financièrement à Pico en utilisant Bountysource, un site Web de financement participatif qui se concentre sur des problèmes individuels et des demandes de fonctionnalités. Reportez-vous simplement à la section « Primes et collectes de fonds » ci-dessous pour plus d'informations.
Pico utilise Bountysource pour autoriser les contributions monétaires au projet. Bountysource est un site Web de financement participatif qui se concentre sur des problèmes individuels et des demandes de fonctionnalités dans des projets Open Source utilisant le micropaiement. Les utilisateurs, ou « contributeurs », peuvent promettre de l'argent pour résoudre un problème spécifique, implémenter de nouvelles fonctionnalités ou développer un nouveau plugin ou un nouveau thème. Les développeurs de logiciels open source, ou « Bounty Hunters », peuvent ensuite reprendre et résoudre ces tâches pour gagner de l'argent.
Évidemment, cela ne permettra pas à un développeur de remplacer un emploi à temps plein, il s'agit plutôt de "prendre un café". Cependant, cela contribue à rapprocher les utilisateurs et les développeurs et montre aux développeurs ce que veulent les utilisateurs et à quel point ils se soucient de certaines choses. Néanmoins, vous pouvez toujours donner de l'argent au projet lui-même, comme un moyen simple de dire « Merci » et de soutenir Pico.
Si vous souhaitez encourager les développeurs à résoudre un problème spécifique ou à implémenter une fonctionnalité, il vous suffit de promettre une nouvelle prime ou de sauvegarder une prime existante.
En tant que développeur, vous pouvez remporter une prime en contribuant simplement à Pico (veuillez vous référer à la section « Contribuer » ci-dessus). Vous n'avez pas besoin d'être un contributeur Pico officiel ! Pico est un projet Open Source, n'importe qui peut ouvrir des pull request et réclamer des primes.
Les contributeurs officiels de Pico ne réclameront pas de primes pour leur propre compte, Pico ne retirera jamais d'argent de Bountysource. Tout l'argent collecté par Pico est utilisé pour promettre de nouvelles primes ou pour soutenir des projets dont dépend Pico.
