Relatable Topics!

..version::20.1.0

Note

Este é um pequeno documento em fase de construção que buscar ser um log para processos importantes que ocorreram durante a construção deste documento.

Comandos básicos no terminal linux

  • cat {opção} |arquivo|:
     {>}criar, [cat _.extens]visualizar,[CTRL+D]sair_editor.
  • cd:Alterna para diretório. {cd -]dir ant., [cd ca/mi/nho] último dir.
  • :cp ../caminho/vigente . : Copia arquivo para a pasta/diretório vigente
  • -f:Força ação do console.
  • ls:Mostra todos os arquivos visíveis e diretórios internos ao vigente.
  • ls -a:Mostra, além dos arquivos visíveis, os ocultos.
  • mkdir:Cria diretório.
  • pip install <programa>:
     Instala o recurso.
  • python |arquivo|:
     Roda o script no console.
  • rm |arquivo|:Deleta arquivo.
  • rmdir |diretório|:
     Deleta diretório vazio.
  • -r:Ação recursiva. Ação de árvore toda
  • sphinx-quickstart:
     Gera arquivos pertinentes à ação python.
  • touch:Cria novo arquivo. Necessita extensão.
  • vi |arquivo|:Mostra o que gerará a documentação. Para sair :wq:.
  • mv <caminho/raiz> <des/ti/no>:
     move arquivo para outro diretório

Comando de articulação pythonanywhere e github

  • git clone “url projeto”:
     clona projeto do github.
  • git status:informa situação do repositório vigente (se existente).
  • git add <file>:Adiciona o documento no mester.
  • git commit -am ‘mensagem’:
     Atualiza as informações no projeto github.
  • git push:Envia conteúdo da IDE para o gestor.
  • git pull:Upa conteúdo do gestor para a IDE.

Erros

  • Non-ASCII ‘Ã’:Parte do código em pt não reconhecido. #-- coding: utf-8 --.
  • No module named ‘bottle’:
     O readthedocs não encontrou o requerimento bottle. Crie um através de um .txt!.
  • *** No rule to make target ‘html’. Stop.:
     Dirija-se ao diretório que apresente o ‘makefile’.
  • sphinx.errors.SphinxError:
     master file /home/../contents.rst not found: master_doc = ‘index’ no conf.py.
  • :brython.js:5218 Uncaught vitollino: Ao rodar o web page o vitollino não foi encontrado por ausênci do _init_. Gere um _init_ no src do seu repositório.
  • uncaught delta error 5218:
     Com certeza é erro de sintaxe no módulo que está tentando importar! vá consertar!
  • WARNING:autodoc: failed to import module ‘delta’; the following exception was raised: Este erro corrobora com a impossibilidade do sphinx importa o que o módulo importa
  • No module named ‘browser’:
     Ele procurou o módulo requerido e não o encontrou. Uma solução é gerar um pythom mínimo dentre a sua documentação. Importe, copie ou mova o mockbrythom para o seu diretório principal
  • : WARNING: Unknown directive type “doctest”: Doctest é uma extensão do sphinx requerida em uma das diretivas do vitollino. Logo, insira-o no conf.py

Importação de diretórios internos

  1. Arquivos importados para o diretório externo ao repositório vigente não aparece na documentação.
  2. Faz-se necessário IMPORTAR as dependências!

Instalação E Uso Do Sphinx

  • Sphinx:É o gerenciador de documentação python. Ele media a transferência para o Read the docs.
  • sphinx-quickstart:
     É encontrado na documentação sphinx como o disparador do processo de documentação.
  • make html:The HTML pages are in build/html. USAR SEMPRE QUE ADICIONAR ALGO QUE TENHA DE SER LIDO EM HTML.
  • Diretivas:
  • toctree:Interno ao rst.py. O toctree é uma diretiva raiz da árvore de índice. É uma maneira de conectar vários arquivos numa única hierarquia.
  • automodule:
  • Extensions:

Operações Python

  • Format():
  • mock:Unittest.mocké uma biblioteca para teste em Python. Ele permite que você substitua partes do seu sistema em teste por objetos simulados e faça afirmações sobre como elas foram usadas.
  • pylint:O Pylint é uma ferramenta de análise de código estática do Python que procura erros de programação, ajuda a impor um padrão de codificação, fareja cheiros de código e oferece sugestões simples de refatoração.

Organização Dos Diretórios

  • dev:Diretório principal de desenvolvimento;
  • Source |src|:Diretório para acomodação de arquivos .py;
  • docs:Diretório para acomodação dos arquivos de documentação;
  • docs/source/conf.py:
     É onde estarão as principais diretrizes de organização do documento;
  • docs/source/index.rst:
     Contém a raiz da árvore de índice ou toctree;

Organização Dos Arquivos

  • :index:Geralmente é uma página principal
  • html:Serve as informações antes compostas de python
  • index.html:

WEB

  • html| mimetype|:
     O MIME type é o mecanismo para dizer ao cliente a variedade de documentos transmitidos. Sintaxe - Tipo/subtipo

HTML

  • index.html:Documento principal que servirá os documentos importados. Necessário fazer para cada nova sala?
  • head:Instruções preliminares para antes de implementar o html
  • body:É o corpo de funcionamento do html a ser rodado.
  • <script type=”text/python”>:
     Diz que a partir desta linha o que está escrito é python

CSS

  • viewport:Auxilia css a redimensionar a tela quando janela for maximizada ou minimizada
    • content=”width=device-width, initial-scale=1”:
       Repassa para o ccs a largura do dispositivo para poder ajustar o Layout

BRYTHON

  • Brython:É o interpretador python escrito em javascript. É um compilador que permite rodar o python dentro do browser.
  • cdn:É um endereço que permite pegar um objeto do servidor mais próximo à minha localização.
  • <body onload=”brython()”>: Carregador visual

VITOLLINO

  • <div id=”pydiv”></div>:
     O vitollino procura no corpo de html cujo id seja pydiv, colocando todos os componentes do vitollino.
  • div:É um container do html. Uma caixinha.