Pico
2.1.4
Pico — это до безумия простая, невероятно быстрая CMS с плоскими файлами.
Посетите нас по адресу http://picocms.org/ и посетите http://picocms.org/about/ для получения дополнительной информации.
Видите букву Unparenthesized a ? b : c ? d : e is not supported. ошибка?
В настоящее время у Pico есть проблемы с версиями PHP новее 8.0. Это связано с зависимостями Пико, а не с самим Пико. В настоящее время существует «альфа-версия» Pico, которую вы можете загрузить в виде предварительной версии, которая решает эту проблему.
Эту «альфа» совершенно безопасно использовать в производстве, поскольку единственными изменениями являются обновленные зависимости и строки номеров версий . Если вам интересно, вы можете подтвердить это, сравнив изменения между ветвями.
В этой ветке предполагалось проделать дополнительную работу, отсюда и метка «3.0», но этого еще не произошло. Продолжается дискуссия о том, чтобы как можно скорее объединить только эти обновленные зависимости в официальное обновление (Pico 2.2 или 3.0).
Приносим извинения за неудобства и благодарим всех пользователей Pico за терпение.
Установить Pico очень просто – и делается за считанные секунды! Если у вас есть доступ к оболочке на вашем сервере (т. е. доступ по SSH), мы рекомендуем использовать Composer. Если нет, используйте предварительно включенный выпуск. Если вы не знаете, что такое «доступ по SSH», перейдите к предварительной версии.
Для Pico требуется PHP 5.3.6+ и включенные расширения PHP dom и mbstring .
Начиная с Pico 2.0, мы рекомендуем по возможности устанавливать Pico с помощью Composer. Поверьте, вы не пожалеете об обновлении Пико! В любом случае, если вы не хотите использовать Composer или просто не можете использовать Composer, потому что у вас нет доступа к оболочке на вашем сервере, не отчаивайтесь, установка Pico с использованием предварительно включенной версии по-прежнему возможна. проще, чем все, что вы знаете!
Откройте оболочку и перейдите в каталог httpdocs (например, /var/www/html ) вашего сервера. Загрузите Composer и запустите его с опцией create-project , чтобы установить его в нужный каталог (например /var/www/html/pico ):
$ curl -sSL https://getcomposer.org/installer | php $ php композитор.phar create-project picocms/pico-composer pico
Какой второй шаг? Нет второго шага. Вот и все! Откройте свой любимый веб-браузер и перейдите к своей новой, невероятно простой, невероятно быстрой CMS с плоскими файлами! Образец содержимого Pico объяснит, как создать свой собственный контент.
Вам знакомо это чувство: вы хотите установить новый веб-сайт, поэтому загружаете все файлы вашей любимой CMS и запускаете сценарий установки — только для того, чтобы обнаружить, что вы забыли сначала создать базу данных SQL? Позже сценарий установки сообщит вам, что права доступа к файлу неправильные. Черт возьми, что это вообще значит? Забудьте об этом, Пико другой!
Загрузите последнюю версию Pico и загрузите все файлы в желаемый каталог установки Pico в каталоге httpdocs (например /var/www/html/pico ) вашего сервера.
Хорошо, вот в чем подвох: здесь нет подвоха. Вот и все! Откройте свой любимый веб-браузер и перейдите к своей новой, невероятно простой, невероятно быстрой CMS с плоскими файлами! Образец содержимого Pico объяснит, как создать свой собственный контент.
Git — это очень мощная распределенная система контроля версий, и ее можно использовать для организации удобного рабочего процесса на вашем веб-сайте Pico. Использование репозитория Git для вашего веб-сайта помогает создавать и развертывать контент, включая совместное редактирование и контроль версий. Если вы хотите управлять своим веб-сайтом в репозитории Git, вы используете установку на основе Composer.
Форкните стартовый проект Composer Pico с помощью кнопки вилки GitHub. Если вы не хотите использовать GitHub, вы можете выбрать любой сервер Git, который вам нужен. Для создания вручную требуется лишь несколько дополнительных шагов: сначала клонируйте репозиторий Git локально, добавьте свой сервер Git в качестве удаленного и переместите репозиторий на этот новый удаленный сервер.
Клонируйте свою вилку локально и добавьте свое содержимое и ресурсы. Вы можете отредактировать файл composer.json Pico.json, включив в него сторонние плагины и темы, или просто добавить свои собственные плагины и темы в plugins Pico соответственно. каталоги themes . Не забудьте зафиксировать изменения и отправить их на свой сервер Git.
Откройте оболочку на своем веб-сервере и перейдите в каталог httpdocs (например, /var/www/html ). Загрузите Composer, клонируйте репозиторий Git в нужный каталог (например, /var/www/html/pico ) и установите зависимости Pico, используя опцию install Composer:
$ curl -sSL https://getcomposer.org/installer | php $ git clone https://github.com/<ВАШЕ_ИМЯ_ПОЛЬЗОВАТЕЛЯ>/<ВАШ_РЕПОЗИТОР> pico $ php композитор.phar --working-dir=pico install
Если вы обновляете содержимое своего веб-сайта, просто зафиксируйте изменения и отправьте их на свой сервер Git. Откройте оболочку на своем веб-сервере и перейдите в каталог установки Pico в каталоге httpdocs (например /var/www/html/pico ) вашего сервера. Получите все изменения с вашего сервера Git и обновите зависимости Pico, используя опцию update Composer:
$ git тянуть Обновление $php композитора.phar
Итак, вы один из тех замечательных людей, которые делают все это возможным? Мы любим вас, ребята! Как разработчик, мы рекомендуем вам клонировать репозиторий Git Pico, а также репозитории Git темы Pico по умолчанию и плагина PicoDeprecated . Вы можете настроить свое рабочее пространство с помощью стартового проекта Pico Composer и включить все компоненты Pico, используя локальные пакеты.
Использование репозиториев Pico Git отличается от использования одного из методов установки, описанных выше. Он предоставляет вам текущую разрабатываемую версию Pico, которая, вероятно, нестабильна и не готова к использованию в производстве !
Откройте оболочку и перейдите в нужный каталог рабочей области разработки Pico в каталоге httpdocs (например /var/www/html/pico ) вашего сервера. Загрузите и распакуйте стартовый проект Pico Composer в каталог workspace :
$ curl -sSL https://github.com/picocms/pico-composer/archive/master.tar.gz | смола xz $ mv рабочее пространство pico-composer-master
Клонируйте репозитории Git всех компонентов Pico (ядро Pico, тему Pico по умолчанию и плагин PicoDeprecated ) в каталог components :
$ компоненты mkdir $ git clone https://github.com/picocms/Pico.gitComponents/pico $ git clone https://github.com/picocms/pico-theme.git компоненты/pico-theme $ git clone https://github.com/picocms/pico-deprecated.git компоненты/pico-deprecated
Попросите Composer использовать локальные репозитории Git в качестве замены пакетов picocms/pico (ядро Pico), picocms/pico-theme (тема Pico по умолчанию) и picocms/pico-deprecated (плагин PicoDeprecated ). Обновите composer.json вашего рабочего пространства разработки (т.е. workspace/composer.json ) соответствующим образом:
{"хранилища": [
{"type": "path","url": "../comComponents/pico","options": { "symlink": true }
},
{"type": "path","url": "../comComponents/pico-theme","options": { "symlink": true }
},
{"type": "path","url": "../comComponents/pico-deprecated","options": { "symlink": true }
}
],"require": {"picocms/pico": "dev-master","picocms/pico-theme": "dev-master","picocms/pico-deprecated": "dev-master","picocms/ композитор-установщик": "^1.0"}
} Загрузите Composer и запустите его с опцией install :
$ curl -sSL https://getcomposer.org/installer | php $ php композитор.phar --working-dir=установка рабочего пространства
Теперь вы можете открыть веб-браузер и перейти в рабочую область разработки Pico. Все изменения, которые вы вносите в компоненты Pico, будут автоматически отражаться в рабочей области разработки.
Кстати, вы также можете найти все компоненты Pico на Packagist.org: ядро Pico, тему Pico по умолчанию, плагин PicoDeprecated и стартовый проект Pico Composer.
Помните, когда вы установили Pico? Это было гениально просто, не так ли? Обновление Пико не имеет значения! Процесс обновления различается в зависимости от того, использовали ли вы Composer или предустановленную версию для установки Pico. Обратите внимание, что перед обновлением всегда следует создавать резервную копию вашей установки Pico!
Pico следует семантическому управлению версиями 2.0 и использует номера версий, например MAJOR . MINOR . PATCH . Когда мы обновляем версию PATCH (например, 2.0.0 до 2.0.1 ), мы вносим исправления ошибок с обратной совместимостью. Если мы изменим версию MINOR (например, 2.0 на 2.1 ), мы добавим функциональность с обратной совместимостью. В обоих случаях обновить Pico очень просто. Просто перейдите к соответствующему разделу «Обновление» ниже.
Но подождите, мы забыли упомянуть, что происходит, когда мы обновляем MAJOR версию (например, 2.0 до 3.0 ). В данном случае мы внесли несовместимые изменения API. Затем мы предоставим соответствующее руководство по обновлению, поэтому перейдите на страницу «Обновление» на нашем веб-сайте.
Обновить Pico очень просто, если вы использовали Composer для установки Pico. Просто откройте оболочку и перейдите в каталог установки Pico в каталоге httpdocs (например, /var/www/html/pico ) вашего сервера. Теперь вы можете обновить Pico, используя всего одну команду:
Обновление $php композитора.phar
Вот и все! Composer автоматически обновит Pico, а также все плагины и темы, которые вы установили с помощью Composer. Обязательно вручную обновите все плагины и темы, которые вы установили вручную.
Хорошо, установить Pico было легко, но обновить Pico будет сложно, не так ли? Боюсь, мне придется вас разочаровать. Это так же просто, как установить Pico!
Сначала вам придется удалить каталог vendor вашей установки Pico (например, если вы установили Pico в /var/www/html/pico , удалите /var/www/html/pico/vendor ). Затем загрузите последнюю версию Pico и загрузите все файлы в существующий каталог установки Pico. Вам будет задан вопрос, хотите ли вы перезаписать такие файлы, как index.php , .htaccess , ... — просто нажмите «Да».
Вот и все! Теперь, когда Pico обновлен, вам необходимо обновить все установленные вами плагины и темы.
Как разработчик, вы должны знать, как оставаться в курсе событий... Для полноты картины: если вы хотите обновить Pico, просто откройте оболочку и перейдите в рабочую область разработки Pico (например, /var/www/html/pico ). Затем извлеките последние коммиты из репозиториев Git ядра Pico, темы Pico по умолчанию и плагина PicoDeprecated . Позвольте Composer обновить ваши зависимости, и все готово.
$ git -C компоненты/pico pull $ git -C компоненты/загрузка пико-темы $ git -C компоненты/pico-устарелое получение $ php композитор.phar --working-dir=обновление рабочей области
Если вы хотите начать использовать Pico, обратитесь к нашей документации для пользователей. Пожалуйста, прочтите примечания к обновлению, если вы хотите обновить Pico 1.0 до Pico 2.0. На нашем сайте вы можете найти официально поддерживаемые плагины и темы. Более широкий выбор сторонних плагинов и тем можно найти в нашей Wiki на страницах плагинов или тем соответственно. Если вы хотите создать свой собственный плагин или тему, обратитесь к разделу «Получение помощи разработчику» ниже.
Если вы разработчик, ознакомьтесь с разделом «Вклад» ниже и нашими правилами участия. Чтобы начать создание плагина или темы, прочтите документацию для разработчиков на нашем веб-сайте.
Если документы не могут ответить на ваш вопрос, вы можете получить помощь, присоединившись к нам на #picocms в Libera.Chat (журналы). Если у вас возникли проблемы с Pico, не стесняйтесь создавать новую проблему на GitHub. По вопросам проблем с плагинами или темами обращайтесь на сайт разработчика этого плагина или темы.
Прежде чем создавать новую проблему, убедитесь, что о проблеме еще не сообщалось с помощью поисковой системы GitHubs. Пожалуйста, опишите вашу проблему как можно более четко и всегда указывайте версию Pico, которую вы используете. Если вы используете плагины , включите и их список. Нам нужна информация о фактическом и ожидаемом поведении , действиях по воспроизведению проблемы и о том, какие шаги вы предприняли для самостоятельного решения проблемы (т. е. самостоятельное устранение неполадок ).
Вы хотите внести свой вклад в Пико? Мы очень ценим это! Вы можете помочь сделать Pico лучше, добавляя код или сообщая о проблемах, но, пожалуйста, обратите внимание на наши рекомендации по участию. В целом вы можете внести свой вклад в трех различных областях:
Плагины и темы. Вы разработчик плагинов или дизайнер тем? Мы любим вас, ребята! Вы можете найти массу информации о том, как разрабатывать плагины и темы, на http://picocms.org/development/. Если вы создали плагин или тему, добавьте его в нашу Wiki на странице плагинов или тем. Вы также можете разместить его на нашем веб-сайте, где он будет отображаться на официальных страницах плагина или темы!
Документация: Мы всегда ценим людей, улучшающих нашу документацию. Вы можете улучшить встроенную пользовательскую документацию или более подробную пользовательскую документацию на нашем веб-сайте. Вы также можете улучшить документацию для разработчиков плагинов и тем. Просто создайте репозиторий Git нашего веб-сайта по адресу https://github.com/picocms/picocms.github.io, измените файлы Markdown и откройте запрос на включение.
Ядро Пико: Высшей дисциплиной является работа над Ядром Пико. Ваш вклад должен помочь каждому пользователю Pico получить больше удовольствия от работы с Pico. В этом случае создайте форк Pico с https://github.com/picocms/Pico и откройте запрос на включение. Мы с нетерпением ждем вашего вклада!
Внося свой вклад в Pico, вы принимаете и соглашаетесь с Сертификатом происхождения разработчика для ваших нынешних и будущих вкладов, отправленных в Pico. Пожалуйста, обратитесь к разделу «Сертификат происхождения разработчика» на нашем CONTRIBUTING.md .
У вас нет времени добавлять код в Pico, но вы все равно хотите «угостить кофе» теми, кто это делает? Вы можете внести денежный вклад в Pico, используя Bountysource, краудфандинговый веб-сайт, который фокусируется на отдельных проблемах и запросах функций. Для получения дополнительной информации просто обратитесь к разделу «Баунти и сбор средств» ниже.
Пико использует Bountysource для внесения денежных пожертвований в проект. Bountysource — это веб-сайт краудфандинга, который фокусируется на отдельных проблемах и запросах функций в проектах с открытым исходным кодом, использующих микроплатежи. Пользователи, или «Спонсоры», могут пожертвовать деньги на устранение конкретной проблемы, реализацию новых функций или разработку нового плагина или темы. Разработчики программного обеспечения с открытым исходным кодом, или «Охотники за головами», могут затем взять и решить эти задачи, чтобы заработать деньги.
Очевидно, что это не позволит разработчику заменить постоянную работу, а скорее нацелено на «постоять кофе». Однако это помогает сблизить пользователей и разработчиков и показывает разработчикам, чего хотят пользователи и насколько их волнуют определенные вещи. Тем не менее, вы все равно можете пожертвовать деньги на сам проект, чтобы это был простой способ сказать «Спасибо» и поддержать Пико.
Если вы хотите побудить разработчиков исправить конкретную проблему или реализовать функцию, просто объявите новую награду или поддержите существующую.
Как разработчик, вы можете получить вознаграждение, просто внося свой вклад в Pico (см. раздел «Вклад» выше). Вам не обязательно быть официальным участником Pico! Pico — это проект с открытым исходным кодом, каждый может открывать запросы на включение и получать вознаграждения.
Официальные участники Pico не будут требовать вознаграждения от своего имени. Pico никогда не будет брать деньги из Bountysource. Все деньги, собранные Пико, используются для обещания новых вознаграждений или для поддержки проектов, от которых зависит Пико.
