Pico
2.1.4
Pico ist ein unglaublich einfaches, blitzschnelles Flatfile-CMS.
Besuchen Sie uns unter http://picocms.org/ und besuchen Sie http://picocms.org/about/ für weitere Informationen.
Wird ein Unparenthesized a ? b : c ? d : e is not supported. Fehler?
Pico hat derzeit Probleme mit PHP-Versionen neuer als 8.0. Dies liegt an den Abhängigkeiten von Pico und nicht an Pico selbst. Derzeit gibt es eine „Alpha“-Version von Pico, die Sie als vorab gebündelte Version herunterladen können, um dieses Problem zu lösen.
Dieses „Alpha“ kann in der Produktion absolut sicher verwendet werden, da die einzigen Änderungen aktualisierte Abhängigkeiten und Versionsnummernzeichenfolgen sind. Wenn Sie neugierig sind, können Sie dies bestätigen, indem Sie die Änderungen zwischen den Zweigen vergleichen.
An diesem Zweig sollte noch mehr Arbeit geleistet werden, daher die Bezeichnung „3.0“, aber das ist noch nicht geschehen. Es gibt eine laufende Diskussion darüber, nur diese aktualisierten Abhängigkeiten so schnell wie möglich als offizielles Update (entweder Pico 2.2 oder 3.0) zusammenzuführen.
Wir entschuldigen uns für die Unannehmlichkeiten und danken allen Pico-Benutzern für ihre Geduld in dieser Angelegenheit.
Die Installation von Pico ist kinderleicht – und in Sekundenschnelle erledigt! Wenn Sie Zugriff auf eine Shell auf Ihrem Server haben (z. B. SSH-Zugriff), empfehlen wir die Verwendung von Composer. Wenn nicht, verwenden Sie eine vorab gebündelte Version. Wenn Sie nicht wissen, was „SSH-Zugriff“ ist, schauen Sie sich die vorab gebündelte Version an.
Pico erfordert PHP 5.3.6+ und die Aktivierung der PHP-Erweiterungen dom und mbstring .
Ab Pico 2.0 empfehlen wir, Pico wann immer möglich mit Composer zu installieren. Vertrauen Sie uns, Sie werden es nicht bereuen, Pico zu aktualisieren! Wie auch immer, wenn Sie Composer nicht verwenden möchten oder Composer einfach nicht verwenden können, weil Sie keinen Zugriff auf eine Shell auf Ihrem Server haben, verzweifeln Sie nicht, die Installation von Pico mit einer vorab gebündelten Version ist immer noch möglich einfacher als alles, was Sie wissen!
Öffnen Sie eine Shell und navigieren Sie zum httpdocs Verzeichnis (z. B. /var/www/html ) Ihres Servers. Laden Sie Composer herunter und führen Sie es mit der Option create-project aus, um es im gewünschten Verzeichnis zu installieren (z. B. /var/www/html/pico ):
$ curl -sSL https://getcomposer.org/installer | php $ php Composer.phar create-project picocms/pico-composer pico
Welcher zweite Schritt? Es gibt keinen zweiten Schritt. Das ist es! Öffnen Sie Ihren bevorzugten Webbrowser und navigieren Sie zu Ihrem brandneuen, unglaublich einfachen, blitzschnellen Flatfile-CMS! Die Beispielinhalte von Pico erklären, wie Sie Ihre eigenen Inhalte erstellen.
Kennen Sie das Gefühl: Sie möchten eine neue Website installieren, laden also alle Dateien Ihres Lieblings-CMS hoch und führen das Setup-Skript aus – nur um dann festzustellen, dass Sie vergessen haben, zuerst die SQL-Datenbank zu erstellen? Später teilt Ihnen das Setup-Skript mit, dass die Dateiberechtigungen falsch sind. Verdammt, was bedeutet das überhaupt? Vergessen Sie es, Pico ist anders!
Laden Sie die neueste Pico-Version herunter und laden Sie alle Dateien in das gewünschte Installationsverzeichnis von Pico im httpdocs Verzeichnis (z. B. /var/www/html/pico ) Ihres Servers hoch.
Okay, hier ist der Haken: Es gibt keinen Haken. Das ist es! Öffnen Sie Ihren bevorzugten Webbrowser und navigieren Sie zu Ihrem brandneuen, unglaublich einfachen, blitzschnellen Flatfile-CMS! Die Beispielinhalte von Pico erklären, wie Sie Ihre eigenen Inhalte erstellen.
Git ist ein sehr leistungsfähiges verteiltes Versionskontrollsystem – und es kann verwendet werden, um einen schönen Workflow rund um Ihre Pico-Website einzurichten. Die Verwendung eines Git-Repositorys für Ihre Website erleichtert die Erstellung und Bereitstellung von Inhalten, einschließlich der gemeinsamen Bearbeitung und Versionskontrolle. Wenn Sie Ihre Website in einem Git-Repository verwalten möchten, verwenden Sie eine Composer-basierte Installation.
Forken Sie Picos Composer-Starterprojekt mit der Fork-Schaltfläche von GitHub. Wenn Sie GitHub nicht verwenden möchten, obwohl dies auch nicht erforderlich ist, können Sie den gewünschten Git-Server auswählen. Das manuelle Forken erfordert lediglich einige zusätzliche Schritte: Klonen Sie zunächst das Git-Repository lokal, fügen Sie Ihren Git-Server als Remote-Server hinzu und übertragen Sie das Repository auf diesen neuen Remote-Server.
Klonen Sie Ihren Fork lokal und fügen Sie Ihre Inhalte und Assets hinzu. Sie können Picos „ composer.json bearbeiten, um Plugins und Themes von Drittanbietern einzuschließen, oder einfach Ihre eigenen Plugins und Themes zu plugins bzw. Themes von Pico hinzufügen. themes . Vergessen Sie nicht, Ihre Änderungen festzuschreiben und auf Ihren Git-Server zu übertragen.
Öffnen Sie eine Shell auf Ihrem Webserver und navigieren Sie zum httpdocs Verzeichnis (z. B. /var/www/html ). Laden Sie Composer herunter, klonen Sie Ihr Git-Repository in das gewünschte Verzeichnis (z. B. /var/www/html/pico ) und installieren Sie Picos Abhängigkeiten mit der install von 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
Wenn Sie den Inhalt Ihrer Website aktualisieren, übernehmen Sie einfach Ihre Änderungen und übertragen Sie sie auf Ihren Git-Server. Öffnen Sie eine Shell auf Ihrem Webserver und navigieren Sie zum Installationsverzeichnis von Pico im httpdocs Verzeichnis (z. B. /var/www/html/pico ) Ihres Servers. Rufen Sie alle Änderungen von Ihrem Git-Server ab und aktualisieren Sie die Abhängigkeiten von Pico mithilfe der update -Option von Composer:
$ git pull $ PHP-Composer.phar-Update
Sie gehören also zu den großartigen Menschen, die das alles möglich machen? Wir lieben euch, Leute! Als Entwickler empfehlen wir Ihnen, das Git-Repository von Pico sowie die Git-Repositorys von Picos Standarddesign und dem PicoDeprecated -Plugin zu klonen. Sie können Ihren Arbeitsbereich mit dem Composer-Starterprojekt von Pico einrichten und alle Komponenten von Pico mithilfe lokaler Pakete einbinden.
Die Verwendung der Git-Repositorys von Pico unterscheidet sich von der Verwendung einer der oben erläuterten Installationsmethoden. Sie erhalten die aktuelle Entwicklungsversion von Pico, die wahrscheinlich instabil und nicht für den Produktionseinsatz bereit ist!
Öffnen Sie eine Shell und navigieren Sie zum gewünschten Verzeichnis des Pico-Entwicklungsarbeitsbereichs im httpdocs Verzeichnis (z. B. /var/www/html/pico ) Ihres Servers. Laden Sie das Composer-Starterprojekt von Pico herunter und extrahieren Sie es in das workspace :
$ curl -sSL https://github.com/picocms/pico-composer/archive/master.tar.gz | tar xz $ mv Pico-Composer-Master-Arbeitsbereich
Klonen Sie die Git-Repositorys aller Pico-Komponenten (Pico-Kern, Picos Standarddesign und das PicoDeprecated -Plugin) in das components :
$ mkdir-Komponenten $ Git-Klon https://github.com/picocms/Pico.git Components/pico $ Git-Klon https://github.com/picocms/pico-theme.git Components/pico-theme $ Git-Klon https://github.com/picocms/pico-deprecated.git Components/pico-deprecated
Weisen Sie Composer an, die lokalen Git-Repositorys als Ersatz für die Pakete picocms/pico (Pico-Kern), picocms/pico-theme (Pico-Standardthema) und picocms/pico-deprecated (das PicoDeprecated -Plugin) zu verwenden. Aktualisieren Sie die composer.json Ihres Entwicklungsarbeitsbereichs (d. h. workspace/composer.json ) entsprechend:
{"Repositorys": [
{"type": "path", "url": "../components/pico", "options": { "symlink": true }
},
{"type": "path", "url": "../components/pico-theme", "options": { "symlink": true }
},
{"type": "path", "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"}
} Laden Sie Composer herunter und führen Sie es mit der install aus:
$ curl -sSL https://getcomposer.org/installer | php $ php Composer.phar --working-dir=workspace install
Sie können jetzt Ihren Webbrowser öffnen und zum Entwicklungsarbeitsbereich von Pico navigieren. Alle Änderungen, die Sie an den Komponenten von Pico vornehmen, werden automatisch im Entwicklungsarbeitsbereich widergespiegelt.
Übrigens finden Sie auch alle Komponenten von Pico auf Packagist.org: Picos Kern, Picos Standard-Theme, das PicoDeprecated -Plugin und Picos Composer-Starterprojekt.
Erinnern Sie sich, als Sie Pico installiert haben? Es war genial einfach, nicht wahr? Ein Upgrade von Pico macht keinen Unterschied! Der Upgrade-Prozess unterscheidet sich je nachdem, ob Sie Composer oder eine vorab gebündelte Version zur Installation von Pico verwendet haben. Bitte beachten Sie, dass Sie vor dem Upgrade immer ein Backup Ihrer Pico-Installation erstellen sollten!
Pico folgt Semantic Versioning 2.0 und verwendet Versionsnummern wie MAJOR . MINOR . PATCH . Wenn wir die PATCH -Version aktualisieren (z. B. 2.0.0 auf 2.0.1 ), haben wir abwärtskompatible Fehlerbehebungen vorgenommen. Wenn wir die MINOR -Version ändern (z. B. 2.0 auf 2.1 ), haben wir die Funktionalität abwärtskompatibel hinzugefügt. In beiden Fällen ist die Aktualisierung von Pico kinderleicht. Gehen Sie einfach weiter unten zu den entsprechenden Upgrade-Abschnitten.
Aber warten Sie, wir haben vergessen zu erwähnen, was passiert, wenn wir die MAJOR -Version aktualisieren (z. B. 2.0 auf 3.0 ). In diesem Fall haben wir inkompatible API-Änderungen vorgenommen. Wir stellen Ihnen dann ein entsprechendes Upgrade-Tutorial zur Verfügung. Besuchen Sie daher bitte die Seite „Upgrade“ auf unserer Website.
Das Aktualisieren von Pico ist kinderleicht, wenn Sie Composer zur Installation von Pico verwendet haben. Öffnen Sie einfach eine Shell und navigieren Sie zum Installationsverzeichnis von Pico im httpdocs Verzeichnis (z. B. /var/www/html/pico ) Ihres Servers. Sie können Pico jetzt mit nur einem einzigen Befehl aktualisieren:
$ PHP-Composer.phar-Update
Das ist es! Composer aktualisiert Pico und alle Plugins und Themes, die Sie mit Composer installiert haben, automatisch. Bitte stellen Sie sicher, dass Sie alle Plugins und Themes, die Sie manuell installiert haben, manuell aktualisieren.
Okay, die Installation von Pico war einfach, aber ein Upgrade von Pico wird schwierig, nicht wahr? Ich fürchte, ich muss dich enttäuschen. Es ist genauso einfach wie die Installation von Pico!
Zuerst müssen Sie das vendor Verzeichnis Ihrer Pico-Installation löschen (z. B. wenn Sie Pico in /var/www/html/pico installiert haben, löschen Sie /var/www/html/pico/vendor ). Laden Sie dann die neueste Pico-Version herunter und laden Sie alle Dateien in Ihr bestehendes Pico-Installationsverzeichnis hoch. Sie werden gefragt, ob Sie Dateien wie index.php , .htaccess , ... überschreiben möchten – klicken Sie einfach auf „Ja“.
Das ist es! Da Pico nun auf dem neuesten Stand ist, müssen Sie alle von Ihnen installierten Plugins und Themes aktualisieren.
Als Entwickler sollten Sie wissen, wie Sie auf dem Laufenden bleiben ... Der Vollständigkeit halber: Wenn Sie Pico aktualisieren möchten, öffnen Sie einfach eine Shell und navigieren Sie zum Entwicklungsarbeitsbereich von Pico (z. B. /var/www/html/pico ). Rufen Sie dann die neuesten Commits aus den Git-Repositorys von Picos Kern, Picos Standarddesign und dem PicoDeprecated -Plugin ab. Lassen Sie Composer Ihre Abhängigkeiten aktualisieren und schon kann es losgehen.
$ git -C Components/Pico Pull $ git -C Components/pico-theme pull $ git -C Components/pico-deprecated pull $ php Composer.phar --working-dir=Workspace-Update
Wenn Sie mit der Verwendung von Pico beginnen möchten, lesen Sie bitte unsere Benutzerdokumente. Bitte lesen Sie die Upgrade-Hinweise, wenn Sie von Pico 1.0 auf Pico 2.0 upgraden möchten. Auf unserer Website finden Sie offiziell unterstützte Plugins und Themes. Eine größere Auswahl an Plugins und Themes von Drittanbietern finden Sie in unserem Wiki auf den Plugin- bzw. Theme-Seiten. Wenn Sie Ihr eigenes Plugin oder Theme erstellen möchten, lesen Sie bitte den Abschnitt „Hilfe als Entwickler erhalten“ weiter unten.
Wenn Sie Entwickler sind, lesen Sie bitte den Abschnitt „Mitwirken“ unten und unsere Beitragsrichtlinien. Um Ihnen den Einstieg in die Erstellung eines Plugins oder Themes zu erleichtern, lesen Sie bitte die Entwicklerdokumente auf unserer Website.
Wenn die Dokumente Ihre Frage nicht beantworten können, können Sie Hilfe erhalten, indem Sie sich uns auf #picocms auf Libera.Chat (Protokolle) anschließen. Wenn Sie Probleme mit Pico haben, zögern Sie bitte nicht, ein neues Problem auf GitHub zu erstellen. Bei Problemen mit Plugins oder Themes informieren Sie sich bitte auf der Website des Entwicklers dieses Plugins oder Themes.
Bevor Sie ein neues Problem erstellen, stellen Sie bitte mithilfe der GitHubs-Suchmaschine sicher, dass das Problem noch nicht gemeldet wurde. Bitte beschreiben Sie Ihr Problem so klar wie möglich und geben Sie immer die von Ihnen verwendete Pico-Version an. Sofern Sie Plugins verwenden, fügen Sie auch eine Liste davon bei. Wir benötigen Informationen über das tatsächliche und erwartete Verhalten , die Schritte zur Reproduktion des Problems und welche Schritte Sie unternommen haben, um das Problem selbst zu lösen (d. h. Ihre eigene Fehlerbehebung ).
Du möchtest zu Pico beitragen? Das wissen wir wirklich zu schätzen! Sie können dazu beitragen, Pico zu verbessern, indem Sie Code beisteuern oder Probleme melden. Beachten Sie jedoch bitte unsere Beitragsrichtlinien. Im Allgemeinen können Sie in drei verschiedenen Bereichen einen Beitrag leisten:
Plugins & Themes: Sie sind Plugin-Entwickler oder Theme-Designer? Wir lieben euch, Leute! Unter http://picocms.org/development/ finden Sie zahlreiche Informationen zur Entwicklung von Plugins und Themes. Wenn Sie ein Plugin oder Theme erstellt haben, fügen Sie es bitte unserem Wiki hinzu, entweder auf der Plugins- oder Themes-Seite. Sie können es auch an unsere Website senden, wo es auf den offiziellen Plugin- oder Theme-Seiten angezeigt wird!
Dokumentation: Wir freuen uns immer über Leute, die unsere Dokumentation verbessern. Sie können entweder die Inline-Benutzerdokumente oder die umfangreicheren Benutzerdokumente auf unserer Website verbessern. Sie können auch die Dokumentation für Plugin- und Theme-Entwickler verbessern. Forken Sie einfach das Git-Repository unserer Website von https://github.com/picocms/picocms.github.io, ändern Sie die Markdown-Dateien und öffnen Sie eine Pull-Anfrage.
Picos Kern: Die Königsdisziplin ist die Arbeit am Picos Kern. Ihr Beitrag soll jedem Pico-Benutzer helfen, eine bessere Erfahrung mit Pico zu machen. Wenn dies der Fall ist, forken Sie Pico von https://github.com/picocms/Pico und öffnen Sie eine Pull-Anfrage. Wir freuen uns auf Ihren Beitrag!
Indem Sie einen Beitrag zu Pico leisten, akzeptieren Sie das Entwickler-Ursprungszertifikat für Ihre gegenwärtigen und zukünftigen Beiträge, die Sie an Pico senden. Weitere Informationen finden Sie im Abschnitt „Entwickler-Herkunftszertifikat“ in unserer CONTRIBUTING.md .
Sie haben keine Zeit, Code zu Pico beizutragen, möchten aber trotzdem denjenigen, die es tun, einen Kaffee servieren? Über Bountysource, eine Crowdfunding-Website, die sich auf individuelle Themen und Funktionswünsche konzentriert, können Sie Geld für Pico spenden. Weitere Informationen finden Sie unten im Abschnitt „Prämien und Spendenaktionen“.
Pico nutzt Bountysource, um finanzielle Beiträge zum Projekt zu ermöglichen. Bountysource ist eine Crowdfunding-Website, die sich auf einzelne Themen und Funktionswünsche in Open-Source-Projekten mithilfe von Mikrozahlungen konzentriert. Benutzer oder „Unterstützer“ können Geld für die Behebung eines bestimmten Problems, die Implementierung neuer Funktionen oder die Entwicklung eines neuen Plugins oder Themes zusagen. Entwickler von Open-Source-Software, sogenannte „Kopfgeldjäger“, können diese Aufgaben dann aufgreifen und lösen, um das Geld zu verdienen.
Dies ermöglicht es einem Entwickler natürlich nicht, einen Vollzeitjob zu ersetzen, sondern zielt eher darauf ab, „einen Kaffee zu trinken“. Es trägt jedoch dazu bei, Benutzer und Entwickler näher zusammenzubringen und zeigt Entwicklern, was Benutzer wollen und wie sehr ihnen bestimmte Dinge am Herzen liegen. Dennoch können Sie Geld für das Projekt selbst spenden, um auf einfache Weise „Danke“ zu sagen und Pico zu unterstützen.
Wenn Sie Entwickler dazu ermutigen möchten, ein bestimmtes Problem zu beheben oder eine Funktion zu implementieren, stellen Sie einfach ein neues Kopfgeld bereit oder unterstützen Sie ein bestehendes.
Als Entwickler können Sie ein Kopfgeld erhalten, indem Sie einfach zu Pico beitragen (siehe Abschnitt „Beitragen“ oben). Sie müssen kein offizieller Pico-Mitwirkender sein! Pico ist ein Open-Source-Projekt, jeder kann Pull-Requests öffnen und Kopfgelder beanspruchen.
Offizielle Pico-Mitwirkende werden keine Kopfgelder in ihrem eigenen Namen einfordern, Pico wird niemals Geld von Bountysource abheben. Das gesamte von Pico gesammelte Geld wird zur Verpfändung neuer Prämien oder zur Unterstützung von Projekten verwendet, von denen Pico abhängig ist.
