Giter Club home page Giter Club logo

tableless / iniciantes Goto Github PK

View Code? Open in Web Editor NEW
371.0 371.0 243.0 1.22 MB

Em uma conversa no Twitter, algumas pessoas identificaram que faltava conteúdo para iniciantes. Resolvemos então criar um conteúdo básico, mínimo para que alguém que esteja iniciando na área consiga aprender informações importantes de forma que ela saiba por onde começar.

Home Page: http://tableless.github.io/iniciantes/

Ruby 2.30% HTML 52.66% JavaScript 32.04% Perl 0.66% CSS 11.40% SCSS 0.93%

iniciantes's Introduction

Netlify Status

Tableless estático baseado em Hugo

Este é o site do Tableless estático. Nada de Wordpress, nem qualquer outro CMS back-end. Os artigos são escritos em Markdown, com um frontmatter em yaml fácil de entender.

Rodando o projeto

Para rodar o projeto você vai precisar do Hugo instalado na sua máquina. Leia o Quick Start direto do site do Hugo para iniciar.

O CSS está usando SASS como pré-processador, para tanto, você precisa ter SASS instalado na máquina. Uma vez instalado, você pode rodar o comando:

sass --watch themes/tableless/static/css/style.sass:themes/tableless/static/css/style.css --style compressed

As vezes quando tento rodar o server do Hugo, acontece de dar um erro no terminal assim: ERROR 2017/09/03 08:56:44 Error: listen tcp 127.0.0.1:1313: socket: too many open files in system

Consegui resolver, eu acho, usando as dicas desse link: https://blog.dekstroza.io/ulimit-shenanigans-on-osx-el-capitan/

Hugo

O gerador que estamos usando agora é o Hugo... um gerador de arquivos estáticos escrito em Go.

Se você quiser contribuir, por favor, clone o projeto e submeta um Pull Request. Mais do que nunca vamos precisar de ajuda agora. Para rodar o projeto, leia o Quick Start do guia do Hugo. É super rápido e não precisa de tanto setup como outros geradores de conteúdo estático.

Submetendo artigos

Se você quer ser um autor, leia nesta página as instruções e submeta seus artigos.

iniciantes's People

Contributors

abensur avatar amandavilela avatar brunoom1 avatar danilovaz avatar daviluis321 avatar diegoeis avatar diegogurgel avatar diegorei avatar euconectei avatar evansantos avatar fnando avatar fsaldanha avatar henriquesilverio avatar jairojair avatar lucascaton avatar luish avatar marcussousa avatar nathan-ramos avatar neylsongularte avatar oswaldoacauan avatar phenriqueleao avatar raphaelfabeni avatar reinaldoferraz avatar renanmpimentel avatar robsonmouras avatar rogeriopradoj avatar thiagoalvernaz avatar vitornp avatar wbruno avatar wmartins avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

iniciantes's Issues

Guia para trabalhar com Jekyll.

Acho que seria legal criar um pequeno guia de instalação e utilização do Jekyll (visando contribuír com o projeto, não é necessário abordar tudo o que o Jekyll disponibiliza).
Isso poderia fazer com que um pessoal mais novo em programação (que possivelmente nunca mexeu com ruby) pudesse contribuír com mais facilidade, sem ter que garimpar tutoriais de instalação na web.

O que acham?

Instalar Prettify Code

Instalar o prettify code para os pedaços de código ficarem mais apresentáves.
Alguém da comunidade podia fazer, né? ;-)

Como um site é hospedado

Pessoal, seria uma boa mostrar aos novos devs como funciona o processo de hospedagem de um site, pois reparei que em muitos cursos não é ensinado, ou falta conteúdo. O que acham?

Isso poderia auxiliar muito no aprendizado dos iniciantes em programação web, pois muitos ficam perdidos no início, como aconteceu comigo.

Leitura offline

Seria uma boa oferecer ao usuário a opção de uma leitura offline. Porque mesmo quando ele estiver sem conectividade com a internet, ele poderá ler ou consultar o conteúdo a qualquer momento.

Remover/alterar o branch master

Ao entrar no projeto existem inúmeros arquivos que não deveriam existir, isto pode deixar os novatos um pouco confusos. Talvez, se o branch master contivesse apenas um arquivo README com instruções do que fazer (para fazer melhorias através de forks) e o link para o projeto final: http://tableless.github.io/iniciantes/

Daí manteria apenas o branch gh-pages

Outra solução seria remover o branch master, mas voltaria a ter vários arquivos do mesmo.

Utilização de posts e categorias do Jekyll

Estava dando uma olhada sobre o Jekyll e existi a opção de posts por categorias, não seria válido a utilização.

Dai ficaria +/- assim:

  • Na Index a listagem de categorias
  • Na categoria a sidebar lateral listagem dos posts conforme a categoria selecionado.

Acredito que facilitaria a criação de novos conteúdos

Tentando rodar o jekyll server -w?

Boa tarde estou tentando rodar local e acontece o seguinte erro alguém sabe o que está acontecendo?

Please report a bug if this causes problems.
Configuration file: /projetos/iniciantes/_config.yml
Deprecation: The 'plugins' configurationoption has been renamed to 'plugins_dir'. Please update your config file accordingly.
Deprecation: The 'layouts' configurationoption has been renamed to 'layouts_dir'. Please update your config file accordingly.
Deprecation: The 'pygments' configuration option has been renamed to 'highlighter'. Please update your config file accordingly. The allowed values are 'rouge', 'pygments' or null.
Deprecation: Please change 'use_coderay' to 'enable_coderay' in your configuration file.
Error: You're using the 'maruku' Markdown processor, which has been removed as of 3.0.0. We recommend you switch to Kramdown. To do this, replace markdown: maruku with markdown: kramdown in your _config.yml file.

O básico de responsive

Colocar um "responsivinho" só para ter uma melhor experiência em celulares. Provavelmente vai ter muita gente lendo isso durante as viagens do dia.

Padronização da forma de criação dos textos

Eu tive um pouco de dúvidas enquanto eu estava criando os textos, quis colocar alguns subtítulos, alguns códigos (tags principalmente) e não tinha certeza de como marcá-los, então fiz o mais 'simples' e coloquei algumas tags como <b>, <i> e <code>.

Acho que seria legal para quem quer contribuír que seja realizado um pequeno guia de contribuição, abordando esses principais casos. Isso facilitaria bastante na hora de criar e editar os textos (e também facilitaria muito se quisessemos mudar o estilo das páginas).

Ferramentas de Versionamento

Comunidade, caberia nesse maravilhoso Guia para Iniciantes uma "aba" sobre Git e GitHub?

Acredito que isso ajudaria a quebrar o gelo dos novatos, o que inclui eu.

Navegação entre os tópicos

Acho que seria bastante útil que ao final de cada página houvessem botões de navegação para o próximo tópico e para o anterior. Pois sempre que termino de ler uma página, tenho que voltar ao topo para selecionar o outro tópico.

Commits em inglês ou português?

Os projetos geralmente possuem um guia para contribuição avisando, também, em qual idioma os commits devem estar.
Como esse é um projeto muito focado na colaboração da comunidade, é importante que isso fique mais claro.

Afinal, os commits devem ser em inglês (mais universal) ou português (mais restrito ao Brasil)?

U

I

Mudança de fonte.

Utilizando Chrome (28.0.1500.72) e Windows 7 a fonte atual (Lato) está deixando a leitura muito cansativa, é necessário esforço para leitura dos textos.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.