Pico é um CMS de arquivo simples estupidamente simples e extremamente rápido.
Visite-nos em http://picocms.org/ e consulte http://picocms.org/about/ para mais informações.
Vendo um Unparenthesized a ? b : c ? d : e is not supported.
erro?
Atualmente, o Pico tem problemas com versões do PHP mais recentes que 8.0. Isto se deve às dependências do Pico, e não ao próprio Pico. Atualmente existe uma versão “alfa” do Pico que você pode baixar como uma versão pré-empacotada que resolve esse problema.
Este "alfa" é perfeitamente seguro para uso em produção, pois as únicas alterações são dependências atualizadas e strings de número de versão . Se estiver curioso, você pode confirmar isso comparando as mudanças entre as filiais.
Pretendia-se que mais trabalho fosse feito neste ramo, daí o rótulo “3.0”, mas isso ainda não aconteceu. Há uma discussão contínua sobre como mesclar apenas essas dependências atualizadas como uma atualização oficial (Pico 2.2 ou 3.0) o mais rápido possível.
Desculpe pelo transtorno e obrigado a todos os usuários do Pico pela paciência com o assunto.
Instalar o Pico é extremamente simples - e feito em segundos! Se você tiver acesso a um shell em seu servidor (ou seja, acesso SSH), recomendamos usar o Composer. Caso contrário, use uma versão pré-empacotada. Se você não sabe o que é “acesso SSH”, vá para a versão pré-empacotada.
O Pico requer PHP 5.3.6+ e as extensões PHP dom
e mbstring
devem estar habilitadas.
A partir do Pico 2.0, recomendamos instalar o Pico usando o Composer sempre que possível. Confie em nós, você não se arrependerá quando se trata de atualizar o Pico! De qualquer forma, se você não quiser usar o Composer, ou se simplesmente não puder usar o Composer porque não tem acesso a um shell no seu servidor, não se desespere, instalar o Pico usando uma versão pré-empacotada ainda é mais fácil do que tudo que você conhece!
Abra um shell e navegue até o diretório httpdocs
(por exemplo, /var/www/html
) do seu servidor. Baixe o Composer e execute-o com a opção create-project
para instalá-lo no diretório desejado (por exemplo, /var/www/html/pico
):
$ curl -sSL https://getcomposer.org/installer | php $ php compositor.phar criar-projeto picocms/pico-composer pico
Qual segundo passo? Não há segundo passo. É isso! Abra seu navegador favorito e navegue até seu novo CMS de arquivo simples, estupidamente simples e extremamente rápido! Os exemplos de conteúdo do Pico explicarão como criar seu próprio conteúdo.
Você conhece a sensação: você deseja instalar um novo site, então carrega todos os arquivos do seu CMS favorito e executa o script de configuração - apenas para descobrir que se esqueceu de criar o banco de dados SQL primeiro? Mais tarde, o script de configuração informa que as permissões do arquivo estão erradas. Caramba, o que isso significa? Esqueça, o Pico é diferente!
Baixe a versão mais recente do Pico e carregue todos os arquivos para o diretório de instalação desejado do Pico dentro do diretório httpdocs
(por exemplo, /var/www/html/pico
) do seu servidor.
Ok, aqui está o problema: não há problema. É isso! Abra seu navegador favorito e navegue até seu novo CMS de arquivo simples, estupidamente simples e extremamente rápido! Os exemplos de conteúdo do Pico explicarão como criar seu próprio conteúdo.
Git é um sistema de controle de versão distribuído muito poderoso - e pode ser usado para estabelecer um bom fluxo de trabalho em seu site do Pico. Usar um repositório Git para o seu site auxilia na criação e implantação de conteúdo, incluindo edição colaborativa e controle de versão. Se quiser gerenciar seu site em um repositório Git, você usa uma instalação baseada no Composer.
Projeto inicial do Composer do Fork Pico usando o botão fork do GitHub. Se não quiser usar o GitHub que não é obrigatório, você pode escolher o servidor Git que desejar. A bifurcação manual requer apenas algumas etapas extras: primeiro clone o repositório Git localmente, adicione seu servidor Git como remoto e envie o repositório para este novo remoto.
Clone seu fork localmente e adicione seu conteúdo e ativos. Você pode editar composer.json
do Pico para incluir plug-ins e temas de terceiros ou simplesmente adicionar seus próprios plug-ins e temas aos plugins
e temas do Pico, respectivamente. diretórios themes
. Não se esqueça de submeter suas alterações e enviá-las ao seu servidor Git.
Abra um shell em seu servidor web e navegue até o diretório httpdocs
(por exemplo, /var/www/html
). Baixe o Composer, clone seu repositório Git para o diretório desejado (por exemplo, /var/www/html/pico
) e instale as dependências do Pico usando a opção install
do Composer:
$ curl -sSL https://getcomposer.org/installer | php $ git clone https://github.com/<SEU_NOME DE USUÁRIO>/<SEU_REPOSITÓRIO> pico $ php compositor.phar --working-dir=pico instalar
Se você atualizar o conteúdo do seu site, simplesmente envie as alterações e envie-as para o seu servidor Git. Abra um shell no seu servidor web e navegue até o diretório de instalação do Pico dentro do diretório httpdocs
(por exemplo /var/www/html/pico
) do seu servidor. Extraia todas as alterações do seu servidor Git e atualize as dependências do Pico usando a opção update
do Composer:
$ git pull $ atualização do php compositor.phar
Então, você é uma dessas pessoas incríveis que tornam tudo isso possível? Nós amamos vocês, pessoal! Como desenvolvedor, recomendamos que você clone o repositório Git do Pico, bem como os repositórios Git do tema padrão do Pico e do plugin PicoDeprecated
. Você pode configurar seu espaço de trabalho usando o projeto inicial Composer do Pico e incluir todos os componentes do Pico usando pacotes locais.
Usar os repositórios Git do Pico é diferente de usar um dos métodos de instalação explicados acima. Ele fornece a versão atual de desenvolvimento do Pico, que provavelmente é instável e não está pronta para uso em produção !
Abra um shell e navegue até o diretório desejado da área de trabalho de desenvolvimento do Pico dentro do diretório httpdocs
(por exemplo /var/www/html/pico
) do seu servidor. Baixe e extraia o projeto inicial do Composer do Pico no diretório workspace
:
$ curl -sSL https://github.com/picocms/pico-composer/archive/master.tar.gz | alcatrão xz $ mv espaço de trabalho pico-composer-master
Clone os repositórios Git de todos os componentes do Pico (núcleo do Pico, tema padrão do Pico e o plugin PicoDeprecated
) no diretório components
:
$ componentes mkdir $ git clone https://github.com/picocms/Pico.git Components/pico $ git clone https://github.com/picocms/pico-theme.git componentes/pico-theme $ git clone https://github.com/picocms/pico-deprecated.git componentes/pico-deprecated
Instrua o Composer a usar os repositórios Git locais como substitutos dos pacotes picocms/pico
(núcleo do Pico), picocms/pico-theme
(tema padrão do Pico) e picocms/pico-deprecated
(o plugin PicoDeprecated
). Atualize o composer.json
do seu espaço de trabalho de desenvolvimento (ou seja, workspace/composer.json
) de acordo:
{"repositórios": [ {"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/ compositor-instalador": "^1.0"} }
Baixe o Composer e execute-o com a opção install
:
$ curl -sSL https://getcomposer.org/installer | php $ php compositor.phar --working-dir=instalação do espaço de trabalho
Agora você pode abrir seu navegador e navegar até o espaço de trabalho de desenvolvimento do Pico. Todas as alterações feitas nos componentes do Pico serão refletidas automaticamente na área de trabalho de desenvolvimento.
A propósito, você também pode encontrar todos os componentes do Pico em Packagist.org: o núcleo do Pico, o tema padrão do Pico, o plugin PicoDeprecated
e o projeto inicial Composer do Pico.
Você se lembra de quando instalou o Pico? Foi engenhosamente simples, não foi? Atualizar o Pico não faz diferença! O processo de atualização difere dependendo se você usou o Composer ou uma versão pré-empacotada para instalar o Pico. Observe que você deve sempre criar um backup da instalação do Pico antes de atualizar!
O Pico segue o Semantic Versioning 2.0 e usa números de versão como MAJOR
. MINOR
. PATCH
. Quando atualizamos a versão PATCH
(por exemplo, 2.0.0
para 2.0.1
), fizemos correções de bugs compatíveis com versões anteriores. Se alterarmos a versão MINOR
(por exemplo, 2.0
para 2.1
), adicionamos funcionalidade de maneira compatível com versões anteriores. Atualizar o Pico é extremamente simples em ambos os casos. Basta acessar as seções de atualização apropriadas abaixo.
Mas espere, esquecemos de mencionar o que acontece quando atualizamos a versão MAJOR
(por exemplo, 2.0
para 3.0
). Neste caso, fizemos alterações de API incompatíveis. Em seguida, forneceremos um tutorial de atualização apropriado; portanto, acesse a página "Atualização" em nosso site.
Atualizar o Pico é muito simples se você usou o Composer para instalar o Pico. Simplesmente abra um shell e navegue até o diretório de instalação do Pico dentro do diretório httpdocs
(por exemplo, /var/www/html/pico
) do seu servidor. Agora você pode atualizar o Pico usando apenas um comando:
$ atualização do php compositor.phar
É isso! O Composer atualizará automaticamente o Pico e todos os plugins e temas que você instalou usando o Composer. Certifique-se de atualizar manualmente todos os plug-ins e temas que você instalou manualmente.
Ok, instalar o Pico foi fácil, mas atualizar o Pico vai ser difícil, não é? Receio ter que decepcioná-lo. É tão simples quanto instalar o Pico!
Primeiro você terá que excluir o diretório vendor
da instalação do Pico (por exemplo, se você instalou o Pico em /var/www/html/pico
, exclua /var/www/html/pico/vendor
). Em seguida, baixe a versão mais recente do Pico e carregue todos os arquivos no diretório de instalação existente do Pico. Você será questionado se deseja sobrescrever arquivos como index.php
, .htaccess
, ... - basta clicar em "Sim".
É isso! Agora que o Pico está atualizado, você precisa atualizar todos os plugins e temas instalados.
Como desenvolvedor você deve saber como se manter atualizado... Para completar, se você quiser atualizar o Pico, basta abrir um shell e navegar até o espaço de trabalho de desenvolvimento do Pico (por exemplo, /var/www/html/pico
). Em seguida, extraia os commits mais recentes dos repositórios Git do núcleo do Pico, do tema padrão do Pico e do plugin PicoDeprecated
. Deixe o Composer atualizar suas dependências e você estará pronto para começar.
$ git -C componentes/pico pull $ git -C componentes/pico-theme pull $ git -C componentes/pico-obsoleto pull $ php compositor.phar --working-dir=atualização do espaço de trabalho
Se você quiser começar a usar o Pico, consulte nossos documentos de usuário. Por favor, leia as notas de atualização se desejar atualizar do Pico 1.0 para o Pico 2.0. Você pode encontrar plug-ins e temas com suporte oficial em nosso site. Uma maior variedade de plug-ins e temas de terceiros pode ser encontrada em nosso Wiki nas páginas de plug-ins ou temas, respectivamente. Se você deseja criar seu próprio plugin ou tema, consulte a seção "Obtendo ajuda como desenvolvedor" abaixo.
Se você é um desenvolvedor, consulte a seção "Contribuições" abaixo e nossas diretrizes de contribuição. Para começar a criar um plugin ou tema, leia a documentação do desenvolvedor em nosso site.
Quando os documentos não conseguem responder à sua pergunta, você pode obter ajuda juntando-se a nós no #picocms no Libera.Chat (logs). Quando você estiver tendo problemas com o Pico, não hesite em criar um novo problema no GitHub. Em relação a problemas com plugins ou temas, consulte o site do desenvolvedor deste plugin ou tema.
Antes de criar um novo problema, certifique-se de que o problema ainda não foi relatado usando o mecanismo de busca GitHubs. Descreva seu problema da forma mais clara possível e sempre inclua a versão do Pico que você está usando. Desde que você esteja usando plug-ins , inclua também uma lista deles. Precisamos de informações sobre o comportamento real e esperado , as etapas para reproduzir o problema e quais etapas você executou para resolver o problema sozinho (ou seja, sua própria solução de problemas ).
Quer contribuir para o Pico? Nós realmente apreciamos isso! Você pode ajudar a melhorar o Pico contribuindo com código ou relatando problemas, mas observe nossas diretrizes de contribuição. Em geral você pode contribuir em três áreas diferentes:
Plugins e temas: você é desenvolvedor de plugins ou designer de temas? Nós amamos vocês, pessoal! Você pode encontrar muitas informações sobre como desenvolver plug-ins e temas em http://picocms.org/development/. Se você criou um plugin ou tema, adicione-o ao nosso Wiki, na página de plugins ou temas. Você também pode enviá-lo para o nosso site, onde será exibido no plugin oficial ou nas páginas do tema!
Documentação: Sempre apreciamos que as pessoas melhorem nossa documentação. Você pode melhorar os documentos do usuário in-line ou os documentos do usuário mais extensos em nosso site. Você também pode melhorar a documentação para desenvolvedores de plugins e temas. Simplesmente bifurque o repositório Git do nosso site em https://github.com/picocms/picocms.github.io, altere os arquivos Markdown e abra uma solicitação pull.
Núcleo do Pico: A disciplina suprema é trabalhar o Núcleo do Pico. Sua contribuição deve ajudar cada usuário do Pico a ter uma experiência melhor com o Pico. Se for esse o caso, bifurque o Pico em https://github.com/picocms/Pico e abra uma solicitação pull. Aguardamos sua contribuição!
Ao contribuir para o Pico, você aceita e concorda com o Certificado de Origem do Desenvolvedor para suas contribuições presentes e futuras enviadas ao Pico. Consulte a seção "Certificado de origem do desenvolvedor" em nosso CONTRIBUTING.md
.
Você não tem tempo para contribuir com código para o Pico, mas ainda quer “preparar um café” para quem o faz? Você pode contribuir com dinheiro para o Pico usando o Bountysource, um site de financiamento coletivo que se concentra em questões individuais e solicitações de recursos. Basta consultar a seção "Recompensas e arrecadação de fundos" abaixo para obter mais informações.
Pico usa Bountysource para permitir contribuições monetárias para o projeto. Bountysource é um site de financiamento coletivo que se concentra em questões individuais e solicitações de recursos em projetos de código aberto usando micropagamento. Os usuários, ou “Apoiadores”, podem doar dinheiro para corrigir um problema específico, implementar novos recursos ou desenvolver um novo plugin ou tema. Os desenvolvedores de software de código aberto, ou “Bounty Hunters”, podem então escolher e resolver essas tarefas para ganhar o dinheiro.
Obviamente, isso não permitirá que um desenvolvedor substitua um emprego de tempo integral, mas sim "tomar um café". No entanto, ajuda a aproximar usuários e desenvolvedores e mostra aos desenvolvedores o que os usuários desejam e o quanto eles se preocupam com determinadas coisas. No entanto, ainda podes doar dinheiro para o projecto em si, como uma forma fácil de dizer "Obrigado" e de apoiar o Pico.
Se você quiser incentivar os desenvolvedores a corrigir um problema específico ou implementar um recurso, basta prometer uma nova recompensa ou apoiar uma existente.
Como desenvolvedor, você pode ganhar uma recompensa simplesmente contribuindo para o Pico (consulte a seção "Contribuindo" acima). Você não precisa ser um Colaborador Oficial do Pico! Pico é um projeto de código aberto, qualquer pessoa pode abrir pull requests e reivindicar recompensas.
Os Colaboradores Oficiais do Pico não reivindicarão recompensas em seu próprio nome, o Pico nunca retirará dinheiro do Bountysource. Todo o dinheiro arrecadado pelo Pico é usado para prometer novas recompensas ou para apoiar projetos dos quais o Pico depende.