Ajuda, recursos e dicas¶
Nós fizemos o nosso melhor para tornar simples PY4WEB e limpo. Mas você sabe, moderno programação web é uma tarefa difícil. Ela exige uma mente aberta, capaz de saltar com frequência (sem ser perdida!) De python para HTML para javascript para css e gestão de banco de dados mesmo. Mas não tenha medo, neste manual vamos ajudá-lo lado a lado nesta jornada. E há muitos outros recursos valiosos que nós vamos mostrar-lhe.
Recursos¶
Este manual¶
Este manual é o Manual de Referência para py4web. Está disponível on-line em https://py4web.com/_documentation/static/index.html, onde você também encontrará o PDF e versão e-book, em vários idiomas. Ele foi originalmente escrito com o formato MarkMin (semelhante ao MarkDown) e exibidas em HTML com uma aplicação py4web personalizado. Em 2020, decidiu converter suas fontes para o formato RST que é mais adequado para documentação técnica. Usando Esfinge eo estilo ReadTheDocs agora somos capazes de alcançar resultados de alta qualidade.
O grupo Google¶
Existe uma lista de discussão dedicado hospedado no Google Groups, consulte https://groups.google.com/g/py4web. Esta é a principal fonte de discussões para desenvolvedores e usuários simples. Para qualquer problema que você deve enfrentar, este é o lugar certo para procurar uma dica ou uma solução.
O bate-papo no IRC¶
Nós também usamos para conversar em algum momento no IRC (Internet Relay Chat, que é um texto de estilo antigo única chat). Você pode se juntar a nós livremente no https://webchat.freenode.net/#py4web. De vez em quando nós também usá-lo para hospedar um bate-papo pública agendada, onde você pode escrever e ler perguntas ao vivo para os desenvolvedores. Transcrições deles são, então, disponível na lista de discussão.
Tutoriais e vídeo¶
Existem alguns tutoriais e vídeos, se você gosta deles. Procurá-los na YouTube <https://www.youtube.com/results?search_query=py4web> __. Há também disponível um livre bom `curso por Luca de Alfaro <https://sites.google.com/a/ucsc.edu/luca/classes/cmps-183-hypermedia-and-the-web/cse-183- spring-2020> `__ na UC Santa Cruz.
As fontes no GitHub¶
Py4web é Open Source, com uma licença BSD v3. Ele está hospedado no GitHub em https://github.com/web2py/py4web, onde você pode ler e estudar todos os seus detalhes internos.
Dicas e sugestões¶
Este parágrafo é dedicado a dicas preliminares, sugestões e dicas que podem ser úteis para saber antes de começar a aprender py4web.
Pré-requisitos¶
A fim de compreender py4web você precisa de pelo menos um conhecimento básico python. Há muitos livros, cursos e tutoriais disponíveis na Web - escolher o que é melhor para você. decoradores do Python, em particular, são um marco de qualquer quadro python web e você tem que compreendê-lo totalmente.
Um local de trabalho python moderna¶
Nos capítulos seguintes, você vai começar a codificar em seu computador. Sugerimos que você configurar um moderno local de trabalho python se você pretende fazê-lo de forma eficiente e segura. Mesmo para a execução de exemplos simples e experimentar um pouco, sugerimos usar um ** Ambiente de Desenvolvimento Integrado ** (IDE). Isso fará com que a sua experiência de programação muito melhor, permitindo verificação de sintaxe, linting e depuração visual. Hoje em dia, existem dois principais escolhas livres e multiplataforma: Microsoft Visual Código Estúdio aka VScode <https://code.visualstudio.com/> __ e JetBrains PyCharm <https://www.jetbrains.com/pycharm/> __.
Quando você vai começar a lidar com programas mais complexos e confiabilidade necessidade, sugerimos também para:
usar ambientes virtuais (também chamado ** virtualenv **, veja aqui <https://docs.python.org/3.7/tutorial/venv.html> __ para uma introdução). Em um ambiente de trabalho complexo isso vai evitar a ser confuso com outros programas Python e módulos
usar um Concurrent Versions System (CVS ** **). Manter o controle de mudanças do seu programa é muito valioso - juntamente com backups que vai salvar sua vida computação! Git e GitHub são os padrões atuais.
Depuração py4web com VScode¶
Você precisa editar o arquivo de configuração vscode launch.json adicionando a variável `` «GEvent»: True``. Além disso, no mesmo arquivo você pode adicionar `` «args»: [ «run», «apps»] ``, a fim de executar py4web.py diretamente.
Depuração py4web com PyCharm¶
Em PyCharm, ative Configurações | Build, Execução, Implantação | Python Debugger | GEvent compatível.
Como contribuir¶
Precisamos da ajuda de todos: apoiar os nossos esforços! Você pode apenas partecipate no grupo Google tentando responder a outras das perguntas, enviar bugs usando ou criar pedidos puxe o repositório GitHub.
Se você deseja corrigir e ampliar este manual, ou mesmo traduzi-lo em uma nova língua estrangeira, você pode ler todas as informações necessárias diretamente no `README específica <https://github.com/web2py/py4web/blob/master/ docs / README.md> `__ no GitHub.