reprotector/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:

Abrir uma issue contendo:
- Título do artigo
- Descrição sucinta do artigo
- Data de publicação
Escrever o artigo e fazer o Pull Request para esse repositório, no branch gh-pages
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

Pelo terminal, vá ao diretório raíz onde seu equinociOS está localizado
Caso não possua o Bundler instalado, execute sudo gem install bundler
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
Execute jekyll serve ou simplesmente jekyll s
Confira qual foi o Server Address gerado pelo jekyll
Abra o navegador e entre no endereço

Data de Publicação

01/03/2017: [Data disponível - Reservar Data]
02/03/2017: [Data disponível - Reservar Data]
03/03/2017: [#146] Introdução a Arquitetura evolutiva - by @cs-bruno-mazzo
04/03/2017: [Data disponível - Reservar Data]
05/03/2017: [Data disponível - Reservar Data]
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

21/03/2017: [#122] Falando sobre App Coordinator artigo - by @shonorio
22/03/2017: [#137] Layout, composição e testes A/B artigo - by @brunogb
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
31/03/2017: [#120] 5 motivos para não utilizar Storyboard artigo - by @shonorio

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.

reprotector / equinociOS