Skip to content

Commit

Permalink
Merge branch 'main' into deandreson-patch-1
Browse files Browse the repository at this point in the history
  • Loading branch information
Misterio77 authored Aug 10, 2023
2 parents de644d3 + ce96dd1 commit e5566a3
Show file tree
Hide file tree
Showing 5 changed files with 104 additions and 52 deletions.
76 changes: 26 additions & 50 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,65 +5,41 @@ em Livre & Open Source**)](https://gelos.club).

## Como contribuir

### Conteúdo simples
Basta clonar o repositório, adicionar (ou modificar) **páginas ou posts**
dentro de `_pages` e `_posts`. Abra um Merge Request para sua mudança.
Para pequenas contribuições, você pode fazer direto pela UI do GitHub. A
maioria das páginas estão em markdown, e cada coleção pode ser encontrada em
sua pasta específica (`_posts`, `_meetings`, `_projects`, etc). O rodapé de
cada página tem um link para seu código fonte no GitHub, então você pode
visitar este link para encontrar o que está buscando

É possível fazer modificações simples direto da interface do github.
Para edições maiores, pedimos que você clone o repositório e rode o site
localmente. Não se preocupe, é bem simples.

### Assuntos mais complexos
## Desenvolvimento e dependências

Para PRs mais complicados, é importante baixar o
[jekyll](https://jekyllrb.com/) e testar o site durante o processo.
### Com Nix

Basta instalar e usar os comandos usuais (`jekyll build` ou `jekyll serve`)
durante o desenvolvimento.
A forma mais fácil é usando o [Nix](https://nixos.org/nix), o gerenciador de
pacotes e sistema de builds que usamos nos projetos do GELOS..

Caso você tenha o [nix](https://nixos.org/), basta usar `nix develop` para
obter uma shell com tudo que você precisa.
Basta usar `nix develop` para entrar numa shell com tudo que você precisa para
desenvolver. Nessa shell você pode usar os comandos do jekyll, como `jekyll
serve`.

## Convenções

### Idioma

Para páginas **navegadas por humanos** (HTML), a URL (decidido pelo nome do
arquivo ou atributo `permalink`) deve ter **o mesmo idioma** que o conteúdo da
página. A primeira opção de idioma deve ser o português. As páginas podem ter
versões internacionalizadas.
Você também pode usar `nix build` e `nix run` para construir/servir o site
preparado para release.

Como as **chaves** (nome de campos) e **variáveis** do jekyll são em inglês, as
nossas também estão em **inglês**. Os conteúdos (valores) nelas devem seguir o
idioma das páginas em que aparecem (na medida do possível).
### Manualmente

Para páginas **acessadas programaticamente** (JSON, por exemplo), a URL e
conteúdo (na medida do possível) devem usar o mesmo idioma. A primeira opção de
idioma deve ser **inglês**, visto que nesses endpoints os nomes dos campos (que
estão em inglẽs) são expostos.
Baixe o `ruby` [seguindo os passos
relevantes](https://www.ruby-lang.org/en/documentation/installation/) para seu
ambiente.

## Estrutura do repositório
Use `bundle install` para instalar as dependências da `Gemfile`, e execute o
jekyll usando `bundle exec jekyll` (por exemplo, `bundle exec jekyll serve`)

### Conteúdo

- `_posts`: Posts (notícias, eventos, documentos). Devem ser criados dentro da
pasta da respectiva categoria, e com data no nome (exemplo:
`2022-01-05-titulo-exemplo.md`). Escreva preferencialmente em markdown.
- `_pages`: Páginas fixas do site, desde home até indexação das categorias.
Podem ser escritos com qualquer extensão, mas normalmente é usado markdown
para páginas simples e html quando se exige mais controle.

### Disposição e estilos
- `_data`: Dados estruturados para serem reusados no site. Por exemplo lista de
navegação ou de pessoas.
- `_includes`: Componentes que podem ser reusados entre páginas.
- `_layouts`: Layouts base para cada tipo de página. Atualmente temos `default`
(usado ou herdado em todas as páginas) e `post` (automaticamente insere
certos dados).
- `_sass`: Arquivos SASS (`.scss` ou `.sass`) para definir estilos. Essa pasta
é especificamente para arquivos de estilo a serem "incluidos".
- `assets` Arquivos que serão servidos na pasta `assets`, inclui favicon e
estilização principal (que importa arquivos da `_sass`).
## Convenções

### Configurações e CI/CD
- `_config.yml`: Configurações do site.
- `default.nix`, `flake.nix` e `flake.lock`: Tooling e definições de
- distribuição, feitas com o gerenciador de pacotes nix.
No momento ainda não temos páginas internacionalizadas, mas a convenção é que a
URL siga sempre o idioma do conteúdo da página. A primeira opção de idioma para
páginas acessadas por humanos deve ser o português.
7 changes: 7 additions & 0 deletions src/_data/communities.yml
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,13 @@
instagram: https://instagram.com/gelos.icmc
website: https://gelos.club/

- name: FLUSP - IME/USP
description: Grupo de extensão da USP com objetivo de estudar e contribuir para projetos de software livre.
telegram: https://t.me/joinchat/BDEctw1URj59ayCWY88qvA
irc: irc://irc.freenode.net#ccsl-usp
facebook: https://facebook.com/flusp/
website: https://flusp.ime.usp.br

- name: Linux Brasil
description: Comunidade brasileira de Linux.
reddit: https://reddit.com/r/linuxbrasil/
Expand Down
44 changes: 44 additions & 0 deletions src/_posts/2023-08-02-debian-day.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
---
title: Debian Day 30 Anos - GELOS Sediará Evento no ICMC
author: Guilherme Paixão
---


No dia 19 de Agosto de 2023, a partir das 14h, o GELOS sediará o Debian Day 2023, que marcará 30 anos do projeto Debian!

O evento será no auditório Fávaro, no ICMC da USP em São Carlos, contará com palestras e *pausa para o café*!

## Sobre o Projeto Debian

O Projeto Debian é uma associação de indivíduos que compartilham de um mesmo ideal: criar um sistema operacional livre, sendo livremente disponível a todes.
Lançado em 1993, o Debian se tornou uma das distribuições GNU/Linux mais usadas no mundo e é conhecida por manter firmes seus ideais de *software* Livre. O Debian deu origem
a várias outras distros muito famosas, como o [Ubuntu](https://ubuntu.com/), [Kali Linux](https://www.kali.org/), [Tails](https://tails.net/), [Linux Mint](https://linuxmint.com/), [Pop!_OS](https://pop.system76.com/), entre outras!

## Sobre o Debian Day

Fundado oficialmente por [Ian Murdock](https://pt.wikipedia.org/wiki/Ian_Murdock) em 16/08/1993. A comunidade Debian celebra seu aniversário, o Debian Day (Dia do Debian), nesta data todo ano (que também tem sido chamado de Debian Appreciation Day (Dia de apreciação do Debian)).

Também existe um dia de atividades chamado Debian Day - [DebianDayDebConf](https://wiki.debian.org/DebianDayDebConf) um pouco antes ou um pouco depois da conferência anual do Debian, a DebConf.

## Debian Day 2023 no Brasil

Além de São Carlos, o Debian Day será celebrado também nas cidades de [Belo Horizonte](https://dcc.ufmg.br/evento-organizado-pelo-dcc-e-a-comunidade-de-software-livre-comemora-30-anos-do-projeto-debian/), [Maceió](https://doity.com.br/debian-day-mcz-2023) e de forma online pelo [Debian Brasil](https://debianbrasil.gitlab.io/debian30anos).

## Cronograma

A ser definido.


## Informações

**Local:** Instituto de Ciências Matemáticas e de Computação (ICMC) da USP - auditório Fávaro, 2º andar bloco 4

**Data:** 19 de Agosto de 2023

**Horário:** 14h às 18h

**Entrada:** Grátis (sujeito à lotação do espaço)

<img width="200px" src="https://salsa.debian.org/debian/debian-flyers/-/raw/master/logo-30-years/logo-debian-30-years.png">


25 changes: 25 additions & 0 deletions src/_projects/debianday-2023.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
title: Debian Day 2023 - 30 Anos de Debian
state: current
author: Charles
lang: pt-BR
---

No dia 19 de Agosto de 2023, a partir das 14h, o GELOS sediará o Debian Day 2023, que marcará 30 anos do projeto Debian!

O será no autirório Fávaro, no ICMC da USP em São Carlos, e contará com palestras e *coffee break*.

## Sobre o Debian Day

Fundado oficialmente por [Ian Murdock](https://pt.wikipedia.org/wiki/Ian_Murdock) em 16/08/1993. A comunidade Debian celebra seu aniversário, o Debian Day (Dia do Debian), nesta data todo ano. (Que também tem sido chamado de Debian Appreciation Day (Dia de apreciação do Debian)).

Também existe um dia de atividades chamado Debian Day - [DebianDayDebConf](https://wiki.debian.org/DebianDayDebConf) um pouco antes ou um pouco depois da conferência anual do Debian, a DebConf.

## Cronograma

Hora | Palestrante | Título | Descrição
---|---|---|---
14:00 | Charles Melara | A definir | A definir
15:00 | Guilherme Paixão | O Debian e a Cultura Livre | A definir
16:00 | -- | Coffee Break | Vamo comer um lanchinho e trocar umas ideias!
17:00 | Prof. Dr. Francisco José Mônaco | A Definir | A Definir
4 changes: 2 additions & 2 deletions src/comunidades.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,15 +34,15 @@ Abaixo estão listadas algumas comunidades brasileiras que tenham como tema FLOS
{% endif %}

{% if community.irc %}
- IRC: [{{community.irc}}](community.irc)
- IRC: [{{community.irc}}]({{ community.irc }})
{% endif %}

{% if community.reddit %}
- Reddit: [{{ community.reddit }}]({{ community.reddit }})
{% endif %}

{% if community.facebook %}
- Facebook: [{{ community.facebook }}](community.facebook)
- Facebook: [{{ community.facebook }}]({{ community.facebook }})
{% endif %}


Expand Down

0 comments on commit e5566a3

Please sign in to comment.