Este é um repositório de apresentações, anotações, livros, apostilas, imagens, vídeos e recursos utilizados em diversas aulas de Administração e TI.
Todo o conteúdo disponibilizado é livre (free/libre), o que significa que você está automaticamente autorizado a baixar, estudar e modificar todo o conteúdo do projeto como você quiser!
Para acessar os conteúdos finais já processados, em .pdf ou outros formatos, acesse a página Materiais
Os textos, imagens, fontes, ícones e eventuais bibliotecas, módulos ou softwares utilizados no site podem ser acessados pelo repositório do projeto no GitHub.
Ao acessar o repositório de aulas.txt, você verá uma tela como a mostrada a seguir:
Nesta página estão todos os conteúdos de texto, imagens, fontes, scripts e bibliotecas utilizados para criar o site e os slides.
Caso deseje baixar ou clonar todo o conteúdo e adaptá-lo aos seus projetos pessoas, faça o download do branch master
.
Para baixar os arquivos de qualquer branch basta clicar no botão
Clone or Download
e em seguida clicar sobreDownload ZIP
Ao baixar e extrair o conteúdo, você terá acesso à seguinte estrutura de pastas e arquivos:
1 | ESTRUTURA DO BRANCH MASTER |
Caso queira utilizar alguma imagem, pdf, fonte, ou modificar algum conteúdo de texto fique a vontade! Só não se esqueça de manter o arquivo LICENSE.txt na pasta ;)
Para baixar o conteúdo bruto (todo este conteúdo é chamado de assets), contendo os arquivos de texto, PDFs, imagens e fontes utilizados no site, você deverá acessar o branch assets
, conforme mostrado abaixo.
Branches do projeto
Todos os slides utilizados no projeto (e o próprio site) são construídos utilizando os assets mostrados acima. No entanto, para renderizar este conteúdo em um site, é necessário utilizar alguns frameworks especiais.
O site deste projeto é hospedado via GitHub Pages utilizando temas disponibilizados pelo framework Hexo.
Para acessar os arquivos utilizados para criar o site e os slides, clique sobre Branch: master
e em seguida clique na opção assets
.
Cada um dos itens mostrados na imagem acima (master, assets e gh-pages) é chamado de branch.
Um branch nada mais é do que a ramificação de um projeto de software ou site. No caso do aulas.txt, há 3 diferentes ramos:
master
: branch responsável pelo armazenamento dos arquivos brutos (assets), das dependências do framework Hexo e das bibliotecas usadas para produzir os slides.assets
: branch responsável pelo armazenamento de todos os conteúdos de texto, imagens e fontes;gh-pages
: branch responsável pelo armazenamento deste site;
O branch assets
contém todo o material bruto utilizado para produzir o site. Isto inclui imagens, fontes, PDFs, documentos e outros arquivos de texto.
Ao baixar este branch, você terá acesso à seguinte estrutura de pastas:
1 | ESTRUTURA DO BRANCH ASSETS |
Caso queira utilizar alguma imagem, pdf, fonte, ou modificar algum conteúdo de texto fique a vontade! Só não se esqueça de manter o arquivo LICENSE.txt na pasta ;)
Por questões de praticidade, o branch gh-pages
é automaticamente atualizado no processo de deployment do Hexo. Por esta razão o mesmo não é modificado manualmente.
Se desejar, você poderá baixar este branch e rodar em sua máquina. O site será corretamente mostrado, mas os slides não!
Rodando o projeto localmente
Como vimos, o master
é o branch responsável por armazenar e gerar todas as páginas do site e todos os slides.
Para converter os arquivos do branch master
no site acessado no gh-pages
é utilizado um framework chamado Hexo.
Caso você queira instalar o site, localmente, com todas as suas funcionalidades (incluindo os slides), siga o passo a passo a seguir:
Primeiramente, você precisará instalar o Node.js em seu computador para garantir que tudo funcione corretamente.
# | Software | O que é? |
---|---|---|
01 | Java Script | (NÃO É NECESSÁRIO INSTALAR) Linguagem de programação utilizada para implementar conteúdos dinâmicos- como mapas interativos, animações gráficas em 2D/3D e vídeos - em sites. |
02 | Node.js | Interpretador de JavaScript repleto de funcionalidades server-side. |
03 | Hexo | Poderoso, simples e rápido framework escrito em Node.js para criação de blogs com arquivos de texto Markdown. |
04 | Markdown | (NÃO É NECESSÁRIO INSTALAR) Linguagem textual capaz de implementar estruturas HTML/XHTML em textos planos. |
Após instalar todos os programas necessários, você deverá baixar o site aulas.txt para o seu computador, por meio do branch master
.
- Download direto do site:
https://github.com/zmdy/aulas.txt/archive/assets.zip
Quando o download finalizar, você deverá extrair os arquivos baixados. Em seguida, acesse a pasta com os arquivos extraídos. A partir desse momento você deverá utilizar um terminal (Prompt de Comando) para executar os passos.
- Acessa a pasta extraída:
cd aulas.txt
Agora basta instalar os módulos Node.js necessários para o funcionamento do Hexo.
- Instalar as dependências Node.js:
npm install
Com o download finalizado, basta gerar os arquivos estáticos do site:
- Gerar os arquivos do site:
hexo generate
E por fim, é só iniciar o servidor Hexo.
- Inicia o servidor:
hexo server
Para acessar o site, vá até o navegador de sua preferência e abra o endereço a seguir:
- Abrir o site com o navegador:
127.0.0.1:4000/aulas.txt
Licenças
aulas.txt
Este projeto como um todo está distribuído com a Licença MIT: a short and simple permissive license with conditions only requiring preservation of copyright and license notices. (Choose a License)
- Sinta-se livre para:
- Distribuir
- Copiar
- Modificar
- Publicar
- Fazer uso comercial
- Fazer uso privado
- Criar conteúdo derivado, utilizando outra licença
- Fazer o que você quiser (literalmente)
- Mas não se esqueça de:
- Manter uma cópia do arquivo LICENSE e atribuir o devido crédito a nóis, porque "dá trabalho pra fazer!"
Guarde no fundo do seu coração que este projeto e todos os seus constituintes vêm com absolutamente nenhuma garantia. O autor e a licença não são responsáveis por quaisquer danos ou problemas causados pelo uso dos recursos aqui distribuídos.
Apresentações e Anotações
Todas as apresentações (slides e anotações) também estão distribuídos com a Licença MIT, pois são renderizadas com a biblioteca Bonisa.js. No entanto, os conteúdos usados nas apresentações são individualmente distribuídos sob diferentes licenças, explicitamente descritas na sessão “LICENÇA” de cada apresentação.
Conteúdos de Mídia
Todo e qualquer conteúdo midiático, incluindo, mas não se limitando a imagens, textos, fontes, músicas, vídeos e ícones, produzidos ou incluídos em uma uma mais apresentações, são distribuídos sob a Licença Creative Commons, explicitamente descrita em cada apresentação ou anotação.
Softwares
Todos os softwares apresentados ou referenciados nos recursos supracitados, incluindo, mas não se limitando a softwares, scripts, funções, classes, módulos, bibliotecas e/ou pacotes são de responsabilidade de seus criadores.
Demais códigos, produzidos explicitamente para uso nos materiais aqui apresentados, são também distribuídos com a Licença MIT ou GNU Lesser General Public License v3.0, conforme apresentado em cada recurso.