Pico adalah CMS file datar yang sangat sederhana, sangat cepat.
Kunjungi kami di http://picocms.org/ dan lihat http://picocms.org/about/ untuk info lebih lanjut.
Melihat Unparenthesized a ? b : c ? d : e is not supported.
kesalahan?
Pico saat ini mengalami masalah dengan versi PHP yang lebih baru dari 8.0. Hal ini disebabkan oleh ketergantungan Pico, dan bukan Pico itu sendiri. Saat ini ada versi "alpha" dari Pico yang dapat Anda unduh sebagai Rilis Pra-Paket yang memecahkan masalah ini.
"Alpha" ini sangat aman untuk digunakan dalam produksi, karena satu-satunya perubahan adalah dependensi yang diperbarui dan string nomor versi . Jika penasaran, Anda bisa memastikannya dengan membandingkan perubahan antar cabang.
Lebih banyak pekerjaan yang dimaksudkan untuk dilakukan pada cabang ini, oleh karena itu diberi label "3.0", tetapi hal itu belum terjadi. Ada diskusi yang sedang berlangsung tentang menggabungkan dependensi yang diperbarui ini sebagai pembaruan resmi (baik Pico 2.2 atau 3.0) sesegera mungkin.
Maaf atas ketidaknyamanan ini, dan terima kasih kepada semua pengguna Pico atas kesabaran Anda dalam masalah ini.
Menginstal Pico sangat sederhana - dan selesai dalam hitungan detik! Jika Anda memiliki akses ke shell di server Anda (yaitu akses SSH), kami sarankan menggunakan Komposer. Jika tidak, gunakan rilis yang sudah dipaketkan sebelumnya. Jika Anda tidak tahu apa itu "akses SSH", buka rilis yang sudah dipaketkan sebelumnya.
Pico memerlukan PHP 5.3.6+ dan ekstensi PHP dom
dan mbstring
untuk diaktifkan.
Dimulai dengan Pico 2.0 kami merekomendasikan menginstal Pico menggunakan Komposer bila memungkinkan. Percayalah pada kami, Anda tidak akan menyesal saat mengupgrade Pico! Lagi pula, jika Anda tidak ingin menggunakan Composer, atau jika Anda tidak bisa menggunakan Composer karena Anda tidak memiliki akses ke shell di server Anda, jangan putus asa, menginstal Pico menggunakan rilis yang sudah dipaketkan tetap saja lebih mudah dari semua yang Anda tahu!
Buka shell dan navigasikan ke direktori httpdocs
(mis. /var/www/html
) di server Anda. Unduh Komposer dan jalankan dengan opsi create-project
untuk menginstalnya ke direktori yang diinginkan (misalnya /var/www/html/pico
):
$ curl -sSL https://getcomposer.org/installer | php $ php composer.phar buat-proyek picocms/pico-composer pico
Langkah kedua apa? Tidak ada langkah kedua. Itu saja! Buka browser web favorit Anda dan navigasikan ke CMS file datar Anda yang baru, sangat sederhana, sangat cepat! Contoh konten Pico akan menjelaskan cara membuat konten Anda sendiri.
Tahukah Anda perasaannya: Anda ingin menginstal situs web baru, jadi Anda mengunggah semua file CMS favorit Anda dan menjalankan skrip pengaturan - hanya untuk mengetahui bahwa Anda lupa membuat database SQL terlebih dahulu? Nanti skrip pengaturan memberi tahu Anda bahwa izin file salah. Heck, apa maksudnya ini? Lupakan saja, Pico berbeda!
Unduh rilis Pico terbaru dan unggah semua file ke direktori instalasi Pico yang diinginkan dalam direktori httpdocs
(misalnya /var/www/html/pico
) di server Anda.
Oke, inilah masalahnya: Tidak ada tangkapan. Itu saja! Buka browser web favorit Anda dan navigasikan ke CMS file datar Anda yang baru, sangat sederhana, sangat cepat! Contoh konten Pico akan menjelaskan cara membuat konten Anda sendiri.
Git adalah sistem kontrol versi terdistribusi yang sangat kuat - dan dapat digunakan untuk membangun alur kerja yang bagus di sekitar situs web Pico Anda. Menggunakan repositori Git untuk situs web Anda membantu pembuatan dan penerapan konten, termasuk pengeditan kolaboratif dan kontrol versi. Jika Anda ingin mengelola situs web Anda di repositori Git, Anda menggunakan instalasi berbasis Komposer.
Proyek awal Komposer Fork Pico menggunakan tombol fork GitHub. Jika Anda tidak ingin menggunakan GitHub yang tidak diwajibkan, Anda dapat memilih server Git apa pun yang Anda inginkan. Forking secara manual hanya memerlukan beberapa langkah tambahan: Pertama, kloning repositori Git secara lokal, tambahkan server Git Anda sebagai remote dan dorong repositori ke remote baru ini.
Kloning fork Anda secara lokal dan tambahkan konten dan aset Anda. Anda dapat mengedit composer.json
Pico untuk menyertakan plugin dan tema pihak ketiga, atau cukup menambahkan plugin dan tema Anda sendiri ke resp plugins
Pico. direktori themes
. Jangan lupa untuk mengkomit perubahan Anda dan mengirimkannya ke server Git Anda.
Buka shell di server web Anda dan navigasikan ke direktori httpdocs
(misalnya /var/www/html
). Unduh Composer, clone repositori Git Anda ke direktori yang diinginkan (misalnya /var/www/html/pico
) dan instal dependensi Pico menggunakan opsi install
Composer:
$ curl -sSL https://getcomposer.org/installer | php $ git clone https://github.com/<YOUR_USERNAME>/<YOUR_REPOSITORY> pico $ php composer.phar --working-dir=pemasangan pico
Jika Anda memperbarui konten situs web Anda, cukup komit perubahan Anda dan kirimkan ke server Git Anda. Buka shell di server web Anda dan navigasikan ke direktori instalasi Pico di dalam direktori httpdocs
(misalnya /var/www/html/pico
) di server Anda. Tarik semua perubahan dari server Git Anda dan perbarui dependensi Pico menggunakan opsi update
Komposer:
$git tarik $ php composer.phar pembaruan
Jadi, Anda salah satu dari orang-orang luar biasa yang membuat semua ini menjadi mungkin? Kami sayang kalian! Sebagai pengembang, kami menyarankan Anda untuk mengkloning repositori Git Pico serta repositori Git dari tema default Pico dan plugin PicoDeprecated
. Anda dapat mengatur ruang kerja Anda menggunakan proyek awal Komposer Pico dan memasukkan semua komponen Pico menggunakan paket lokal.
Menggunakan repositori Git Pico berbeda dengan menggunakan salah satu metode instalasi yang dijelaskan di atas. Ini memberi Anda versi pengembangan Pico saat ini, yang mungkin tidak stabil dan belum siap untuk penggunaan produksi !
Buka shell dan navigasikan ke direktori ruang kerja pengembangan Pico yang diinginkan dalam direktori httpdocs
(misalnya /var/www/html/pico
) di server Anda. Unduh dan ekstrak proyek starter Komposer Pico ke dalam direktori workspace
:
$ curl -sSL https://github.com/picocms/pico-composer/archive/master.tar.gz | tar xz $ mv ruang kerja pico-komposer-master
Kloning repositori Git dari semua komponen Pico (inti Pico, tema default Pico, dan plugin PicoDeprecated
) ke dalam direktori components
:
$ komponen mkdir $ git clone https://github.com/picocms/Pico.git komponen/pico $ git clone https://github.com/picocms/pico-theme.git komponen/pico-theme $ git clone https://github.com/picocms/pico-deprecated.git komponen/pico-deprecated
Perintahkan Komposer untuk menggunakan repositori Git lokal sebagai pengganti paket picocms/pico
(inti Pico), picocms/pico-theme
(tema default Pico) dan paket picocms/pico-deprecated
(plugin PicoDeprecated
). Perbarui composer.json
ruang kerja pengembangan Anda (yaitu workspace/composer.json
) sesuai:
{"repositori": [ {"type": "jalur","url": "../components/pico","options": { "symlink": true } }, {"type": "path","url": "../components/pico-theme","options": { "symlink": true } }, {"type": "path","url": "../components/pico-deprecated","options": { "symlink": true } } ],"wajib": {"picocms/pico": "dev-master","picocms/pico-theme": "dev-master","picocms/pico-deprecated": "dev-master","picocms/ komposer-installer": "^1.0"} }
Unduh Komposer dan jalankan dengan opsi install
:
$ curl -sSL https://getcomposer.org/installer | php $ php composer.phar --working-dir=instal ruang kerja
Anda sekarang dapat membuka browser web Anda dan menavigasi ke ruang kerja pengembangan Pico. Semua perubahan yang Anda buat pada komponen Pico akan otomatis tercermin di ruang kerja pengembangan.
Omong-omong, Anda juga dapat menemukan semua komponen Pico di Packagist.org: inti Pico, tema default Pico, plugin PicoDeprecated
, dan proyek awal Komposer Pico.
Apakah Anda ingat saat Anda menginstal Pico? Itu sangat sederhana, bukan? Meningkatkan Pico tidak ada bedanya! Proses pemutakhiran berbeda-beda bergantung pada apakah Anda menggunakan Composer atau rilis yang sudah dipaketkan sebelumnya untuk menginstal Pico. Harap dicatat bahwa Anda harus selalu membuat cadangan instalasi Pico Anda sebelum memutakhirkan!
Pico mengikuti Semantic Versioning 2.0 dan menggunakan nomor versi seperti MAJOR
. MINOR
. PATCH
. Saat kami memperbarui versi PATCH
(misalnya 2.0.0
ke 2.0.1
), kami melakukan perbaikan bug yang kompatibel dengan versi sebelumnya. Jika kami mengubah versi MINOR
(misalnya 2.0
menjadi 2.1
), kami menambahkan fungsionalitas dengan cara yang kompatibel dengan versi sebelumnya. Memutakhirkan Pico sangatlah mudah dalam kedua kasus tersebut. Cukup buka bagian Peningkatan yang sesuai di bawah.
Tapi tunggu dulu, kami lupa menyebutkan apa yang terjadi jika kami memperbarui versi MAJOR
(misalnya 2.0
ke 3.0
). Dalam hal ini kami membuat perubahan API yang tidak kompatibel. Kami kemudian akan memberikan tutorial peningkatan yang sesuai, jadi silakan buka halaman "Peningkatan" di situs web kami.
Memutakhirkan Pico sangatlah mudah jika Anda menggunakan Komposer untuk menginstal Pico. Cukup buka shell dan navigasikan ke direktori instalasi Pico di dalam direktori httpdocs
(misalnya /var/www/html/pico
) di server Anda. Anda sekarang dapat memutakhirkan Pico hanya dengan satu perintah:
$ php composer.phar pembaruan
Itu saja! Komposer akan secara otomatis memperbarui Pico dan semua plugin serta tema yang Anda instal menggunakan Komposer. Harap pastikan untuk memperbarui secara manual semua plugin dan tema yang telah Anda instal secara manual.
Oke, menginstal Pico itu mudah, tapi mengupgrade Pico pasti sulit, bukan? Aku khawatir aku harus mengecewakanmu. Semudah menginstal Pico!
Pertama, Anda harus menghapus direktori vendor
instalasi Pico Anda (misalnya jika Anda telah menginstal Pico ke /var/www/html/pico
, hapus /var/www/html/pico/vendor
). Kemudian unduh rilis Pico terbaru dan unggah semua file ke direktori instalasi Pico yang ada. Anda akan ditanya apakah Anda ingin menimpa file seperti index.php
, .htaccess
, ... - cukup tekan "Ya".
Itu saja! Sekarang Pico sudah diperbarui, Anda perlu memperbarui semua plugin dan tema yang telah Anda instal.
Sebagai seorang pengembang, Anda harus tahu cara untuk tetap up-to-date... Demi kelengkapan, jika Anda ingin memutakhirkan Pico, cukup buka shell dan navigasikan ke ruang kerja pengembangan Pico (misalnya /var/www/html/pico
). Kemudian tarik komit terbaru dari repositori Git inti Pico, tema default Pico, dan plugin PicoDeprecated
. Biarkan Komposer memperbarui dependensi Anda dan Anda siap berangkat.
$ git -C komponen/tarikan pico $ git -C komponen/tarikan tema pico $ git -C komponen/tarikan yang tidak digunakan lagi pico $ php composer.phar --working-dir=pembaruan ruang kerja
Jika Anda ingin mulai menggunakan Pico, silakan merujuk ke dokumen pengguna kami. Silakan baca catatan peningkatan jika Anda ingin meningkatkan dari Pico 1.0 ke Pico 2.0. Anda dapat menemukan plugin dan tema yang didukung secara resmi di situs web kami. Pilihan plugin dan tema pihak ketiga yang lebih banyak dapat ditemukan di Wiki kami di masing-masing halaman plugin atau tema. Jika Anda ingin membuat plugin atau tema sendiri, lihat bagian "Mendapatkan Bantuan sebagai pengembang" di bawah.
Jika Anda seorang pengembang, lihat bagian "Berkontribusi" di bawah dan pedoman kontribusi kami. Untuk membantu Anda mulai membuat plugin atau tema, silakan baca dokumen pengembang di situs web kami.
Jika dokumen tidak dapat menjawab pertanyaan Anda, Anda bisa mendapatkan bantuan dengan bergabung dengan kami di #picocms di Libera.Chat (logs). Jika Anda mengalami masalah dengan Pico, jangan ragu untuk membuat Masalah baru di GitHub. Mengenai masalah plugin atau tema, silakan merujuk ke situs web pengembang plugin atau tema ini.
Sebelum membuat Masalah baru, pastikan masalah tersebut belum dilaporkan menggunakan mesin pencari GitHubs. Harap jelaskan masalah Anda sejelas mungkin dan selalu sertakan versi Pico yang Anda gunakan. Asalkan Anda menggunakan plugin , sertakan juga daftarnya. Kami memerlukan informasi tentang perilaku aktual dan yang diharapkan , langkah-langkah untuk mereproduksi masalah, dan langkah-langkah apa yang telah Anda ambil untuk menyelesaikan sendiri masalah tersebut (yaitu pemecahan masalah Anda sendiri ).
Anda ingin berkontribusi pada Pico? Kami sangat menghargainya! Anda dapat membantu menjadikan Pico lebih baik dengan menyumbangkan kode atau melaporkan masalah, namun harap perhatikan pedoman kontribusi kami. Secara umum Anda dapat berkontribusi dalam tiga bidang berbeda:
Plugin & Tema: Anda seorang pengembang plugin atau perancang tema? Kami sayang kalian! Anda dapat menemukan banyak informasi tentang cara mengembangkan plugin dan tema di http://picocms.org/development/. Jika Anda sudah membuat plugin atau tema, silakan tambahkan ke Wiki kami, baik di halaman plugin atau tema. Anda juga dapat mengirimkannya ke situs web kami, di mana itu akan ditampilkan di halaman plugin atau tema resmi!
Dokumentasi: Kami selalu menghargai orang-orang yang menyempurnakan dokumentasi kami. Anda dapat menyempurnakan dokumen pengguna sebaris atau dokumen pengguna yang lebih luas di situs web kami. Anda juga dapat menyempurnakan dokumen untuk pengembang plugin dan tema. Cukup fork repositori Git situs web kami dari https://github.com/picocms/picocms.github.io, ubah file Markdown dan buka permintaan tarik.
Inti Pico: Disiplin tertinggi adalah mengerjakan Inti Pico. Kontribusi Anda akan membantu setiap pengguna Pico mendapatkan pengalaman yang lebih baik dengan Pico. Jika demikian, fork Pico dari https://github.com/picocms/Pico dan buka permintaan tarik. Kami menantikan kontribusi Anda!
Dengan berkontribusi pada Pico, Anda menerima dan menyetujui Surat Keterangan Asal Pengembang atas kontribusi Anda saat ini dan di masa mendatang yang dikirimkan ke Pico. Silakan lihat bagian "Sertifikat Asal Pengembang" di CONTRIBUTING.md
kami.
Anda tidak punya waktu untuk menyumbangkan kode ke Pico, namun masih ingin "berdiri minum kopi" untuk mereka yang melakukannya? Anda dapat menyumbangkan uang ke Pico menggunakan Bountysource, situs web crowdfunding yang berfokus pada masalah individu dan permintaan fitur. Lihat saja bagian "Bounty dan Penggalangan Dana" di bawah untuk informasi lebih lanjut.
Pico menggunakan Bountysource untuk mengizinkan kontribusi moneter pada proyek tersebut. Bountysource adalah situs crowdfunding yang berfokus pada masalah individu dan permintaan fitur dalam proyek Open Source menggunakan pembayaran mikro. Pengguna, atau "Pendukung", dapat menjanjikan uang untuk memperbaiki masalah tertentu, menerapkan fitur baru, atau mengembangkan plugin atau tema baru. Pengembang perangkat lunak sumber terbuka, atau "Pemburu Hadiah", kemudian dapat mengambil dan menyelesaikan tugas-tugas ini untuk mendapatkan uang.
Jelas hal ini tidak akan memungkinkan pengembang untuk mengganti pekerjaan penuh waktu, ini lebih bertujuan untuk "berdiri minum kopi". Namun, hal ini membantu mendekatkan pengguna dan pengembang, dan menunjukkan kepada pengembang apa yang diinginkan pengguna dan seberapa besar kepedulian mereka terhadap hal-hal tertentu. Meskipun demikian Anda masih dapat menyumbangkan uang untuk proyek itu sendiri, sebagai cara mudah untuk mengucapkan "Terima Kasih" dan untuk mendukung Pico.
Jika Anda ingin mendorong pengembang untuk memperbaiki masalah tertentu atau mengimplementasikan fitur, cukup menjanjikan hadiah baru atau mendukung hadiah yang sudah ada.
Sebagai pengembang, Anda dapat memperoleh hadiah hanya dengan berkontribusi pada Pico (lihat bagian "Berkontribusi" di atas). Anda tidak harus menjadi Kontributor Pico resmi! Pico adalah proyek Open Source, siapa pun dapat membuka permintaan penarikan dan mengklaim hadiah.
Kontributor Resmi Pico tidak akan mengklaim hadiah atas nama mereka sendiri, Pico tidak akan pernah mengambil uang apa pun dari Bountysource. Semua uang yang dikumpulkan oleh Pico digunakan untuk menjaminkan hadiah baru atau untuk mendukung proyek yang menjadi sandaran Pico.