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

There are many tutorials and videos if you like them. Generally, you can search for them on YouTube.

Here are some of them:

  • the free video course by Luca de Alfaro at UC Santa Cruz.

  • the py4web blog app by Andrew Gavgavian, which uses py4web to replicate the famous Corey Schafer’s tutorial series on creating a blog app in Django

As fontes no GitHub

Last but not least, py4web is Open Source, with a BSD v3 licence, hosted on GitHub at https://github.com/web2py/py4web. This means that you can read, study and experiment with all of its internal details by yourself.

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

In order to run py4web.py directly, you need to add "args": ["run", "apps"] to the vscode launch.json configuration file. In addition, if you should get gevent errors you have to add "gevent": true on the same configuration file.

Depuração py4web com PyCharm

In PyCharm, if you should get gevent errors you need to enable Settings | Build, Execution, Deployment | Python Debugger | Gevent compatible.

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.

It’s really simple! Just change the .RST files in the /doc folder and create a Push Request on the GitHub repository at https://github.com/web2py/py4web - you can even do it within your browser. Once the PR is accepted, your changes will be written on the master branch, and will be reflected on the web pages / pdf / epub at the next output generation on the branch.