Criar primeiro tutorial e setup com Github Pages

[wandersoncferreira]

@ericdallo comentou sobre utilizar Material Markdown para publicar os tutoriais postados aqui como uma página web via Github Pages.

Eric, se você puder descrever um pouco o setup necessário aqui na issue de como você está pensando em fazer isso dado a experiencia nos repos do lsp-mode e clojure-lsp.

[ericdallo]

Claro, a idéia era usar o mkdocs-material, um gerador de site estatico a partir de markdown somente, alguns sites ja usam como: Calva, clojure-lsp, Emacs-LSP e outros.

Basicamente precisariamos de um mkdocs.yaml configurando tema e outras opcoes do site e uma pasta docs contendo arquivos/pastas com os markdows. Poderiamos configurar um CI como este onde pusharia para uma branch e hospedariamos de graça via Github Pages.

Podemos ter essa pagina com os tutoriais/guias/sugestoes que achamos que faz sentido para a comunidade, e para contribuir com a pagina, so precisaria de pull requests adicionando um markdown :)

[edipofederle]

Olá Pessoal, qual o status disso?

[ericdallo]

@edipofederle ngm mais opinou nisso, mas minha sugestao segue a mesma do meu comentario acima se fizer sentido

[edipofederle]

@edipofederle ngm mais opinou nisso, mas minha sugestao segue a mesma do meu comentario acima se fizer sentido

Certo, então a ideia é manter isso aqui nesse repositório mesmo? ou criar um novo?

[ericdallo]

Poderia ser neste aqui mesmo, não vejo nenhum problema

[edipofederle]

Acabei puxando algumas coisas aqui, mas me dei conta que já temos o https://github.com/clj-br/clj-br.github.io (http://clojurebrasil.com.br/), esse é feito com Clojure (basicamente com templates hiccup2).

Acho que seria interessante termos um único lugar para tudo ? talvez fazer tudo via mkdocs?

O que acham?

[ericdallo]

Concordo, acho o mkdocs muito fácil de manter onde qualquer um pode facilmente criar/editar algo

[edipofederle]

@pbalduino acho que voce que criou/mantem o clj-br/clj-br o que acha sobre termos um único lugar e via mkdocs, como discutido acima?