CocoaHeadsBrasil / equinociOS

#equinociOS

No dia 20 de março acontece o Equinócio*! Para celebrarmos este evento, iremos escrever, a partir do primeiro dia do mês, 20 artigos sobre temas de conhecimento elemental que qualquer desenvolvedor iOS deve dominar.

Workflow de colaboração

Para colaborar com algum artigo, o autor deve seguir o seguinte fluxo:

1. Abrir uma issue contendo:
   • Título do artigo
   • Descrição sucinta do artigo
   • Data de publicação
2. Escrever o artigo e fazer o Pull Request para esse repositório, no branch gh-pages
3. Certificar-se de que o artigo se encontra sob a licença Creative Commons

Como fazer Pull Request do artigo

• Faça um fork, baixe ou clone o repositório https://github.com/CocoaHeadsBrasil/equinociOS.git
• Escreva seu artigo dentro do diretório _posts (que contém todos os posts do blog e que por sua vez são escrito na linguagem de marcação markdown).
• Faça o Pull Request

Estrutura do post

Todos os posts devem ter o seguinte nome: 2017-02-15-welcome-to-jekyll.markdown, onde YYYY-MM-DD-nome-do-artigo.markdown.

Todos os posts devem conter o seguinte cabeçalho:

---
layout:     post
title:      "Titulo do Artigo"
subtitle:   "Subtitulo do Artigo"
date:       YYYY-MM-DD 12:00:00
author:     "Nome do Autor"
header-img: "img/nomeDoUsuario/imagem.jpg" (imagem de cabeçalho)
category:   Categoria
---

Como salvar imagens

Caso seu post tenha imagens, você deve adiciona-las no diretório img. Porém não insira a imagem na raíz do diretório! Crie um novo diretório com o nome do seu usuário e salve suas imagens nele. ;)

Sempre que você for utilizar a imagem, insira o caminho dela: img/nomeDoUsuario/imagem.jpg

Como utilizar as imagens nos posts

Utilize {{ site.baseurl }} para concatenar com o diretório de imagem, como no exemplo abaixo:

<img src="{{ site.baseurl }}/img/nomeDoUsuario/imagem.jpg">

Como editar markdown

Para escrever seu artigo, você pode utilizar editores markdown como o MacDown ou Atom!

Revisão dos artigos

É importante os colaboradores revisarem os artigos para não serem publicados com erros ortográficos ou erros técnicos!

Você já pode ir fazendo Pull Request do seu artigo dentro do diretório _posts, pois ele só será exibido quando a data que foi especificada no cabeçalho chegar!

É muito importante seu artigo estar pronto alguns dias antes da data de publicação, caso contrário medidas serão tomadas para manter as publicações diárias.

Como rodar localmente

1. Pelo terminal, vá ao diretório raíz onde seu equinociOS está localizado
2. Caso não possua o Bundler instalado, execute sudo gem install bundler
3. Se for a primeira vez que você irá rodar esse projeto, execute bundle install para garantir que todas as dependências que o projeto utiliza existem. Caso negativo, o download será efetuado
4. Execute jekyll serve ou simplesmente jekyll s
5. Confira qual foi o Server Address gerado pelo jekyll
6. Abra o navegador e entre no endereço

Posts de 2017

• 03/03/2017: [#146] Introdução a Arquitetura evolutiva - by @cs-bruno-mazzo
• 06/03/2017: [#125] Por que a interface gráfica é um XML? - by @ronflima
• 07/03/2017: [#156] Unit Tests 101 - by @emannuelOC
• 08/03/2017: [#133] LLDB é seu amigo artigo - by @Bunn
• 09/03/2017: [#138] Snapshot Testing artigo - by @chrisfsampaio
• 10/03/2017: [#129] Reporte de Bugs Para a Apple artigo - by @fjcaetano
• 11/03/2017: [#143] Experiências na modularização de um SDK artigo - by @talesp
• 12/03/2017: [#123] Testes de UI com Embassy e Ambassador artigo - by @emannuelOC
• 13/03/2017: [#131] Introdução e casos de uso: Map, Filter e Reduce. artigo - by @ezefranca
• 14/03/2017: [#124] Começando a implementar VIPER artigo - by @vitormesquita
• 15/03/2017: [#119] Metaprogramação para o resto de nós artigo - by @fpg1503
• 16/03/2017: [#126] Eu preciso reativar minha aplicação? artigo - by @Viniciuscarvalho
• 17/03/2017: [#132] Enums pra você e pro seu código artigo - by @dbonates
• 18/03/2017: [#130] Com quantas views se faz uma APP? - by @ronanrodrigo
• 19/03/2017: [#144] Server-side: características de um servidor - by @ronflima
• 20/03/2017: [#121] Garimpando UIView desmistificando o Core Animator artigo - by @renatosarro

Artigos extras

• 23/03/2017: [#139] Machine Learning em Swift artigo - by @luksfarris
• 24/03/2017: [#127] Sincronização de dados com CloudKit artigo - by @insidegui
• 25/03/2017: [#140] Gerenciando subscriptions com IAP artigo - by @reprotector
• 26/03/2017: [#142] Integração Contínua com Travis CI artigo - by @serralvo
• 27/03/2017: [#136] CoreBluetooth na prática artigo - by @LeonardoCardoso
• 28/03/2017: [#135] Adotando Handoff em apps iOS e macOS artigo - by @rafaelnobrepd
• 29/03/2017: [#134] Interfaces Assíncronas com AssyncDisplayKit artigo - by @gugaoliveira
• 30/03/2017: [#141] Persistência de dados usando Core Data artigo - by @douglastaquary

Muito obrigado a todos que contribuiram! 🎉

Contato

Para desenvolvedores que acharam a iniciativa interessante e quiserem se juntar e conhecer a comunidade de desenvolvedores iOS brasileira, se cadastre no Slack do iOSDevBr.

(*) Em março, ocorre o equinócio de outono no hemisfério sul. No hemisfério norte, na mesma data ocorre o equinócio de primavera.