pythonclub · rg3915 · May 14, 2014 · May 14, 2014 · May 14, 2014 · May 14, 2014
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,10 @@
+# Python
+__pycache__/
+*.py[cod]
+
+# pelican
+output/
+*.pid
+
+# OS
+Thumbs.db
diff --git a/.gitmodules b/.gitmodules
@@ -0,0 +1,4 @@
+[submodule "pelican-plugins"]
+	path = pelican-plugins
+	url = https://github.com/getpelican/pelican-plugins.git
+	branch = master
diff --git a/.nojekyll b/.nojekyll
diff --git a/.travis.yml b/.travis.yml
@@ -0,0 +1,20 @@
+branches:
+  only:
+  - pelican
+language: python
+python:
+- 2.7
+install:
+- pip install -r requirements.txt --use-mirrors
+script:
+- make publish
+notifications:
+  email:
+    on_success: never
+    on_failure: never
+env:
+  global:
+  - secure: fjtVZfyJ7SOg1Glo3T6zYyyzf3OcBiIKY3Lx2abwNt3jIrZalTAc/T2EpeRF+0cLp4NAhHGxylD/pQahWYAw30+SBD5wghd9iBpbJmTxyWHaM9zdLHiU5M3fuSeRwRdIVSG46tLv5wulCIBDubw/b32Ewc4VfEqHtjIahBuGvr4=
+before_install:
+- git submodule update --init --recursive
+after_success: bash deploy.sh
diff --git a/Makefile b/Makefile
@@ -0,0 +1,108 @@
+PY=python
+PELICAN=pelican
+PELICANOPTS=
+
+BASEDIR=$(CURDIR)
+INPUTDIR=$(BASEDIR)/content
+OUTPUTDIR=$(BASEDIR)/output
+CONFFILE=$(BASEDIR)/pelicanconf.py
+PUBLISHCONF=$(BASEDIR)/publishconf.py
+
+FTP_HOST=localhost
+FTP_USER=anonymous
+FTP_TARGET_DIR=/
+
+SSH_HOST=localhost
+SSH_PORT=22
+SSH_USER=root
+SSH_TARGET_DIR=/var/www
+
+S3_BUCKET=my_s3_bucket
+
+CLOUDFILES_USERNAME=my_rackspace_username
+CLOUDFILES_API_KEY=my_rackspace_api_key
+CLOUDFILES_CONTAINER=my_cloudfiles_container
+
+DROPBOX_DIR=~/Dropbox/Public/
+
+DEBUG ?= 0
+ifeq ($(DEBUG), 1)
+	PELICANOPTS += -D
+endif
+
+help:
+	@echo 'Makefile for a pelican Web site                                        '
+	@echo '                                                                       '
+	@echo 'Usage:                                                                 '
+	@echo '   make html                        (re)generate the web site          '
+	@echo '   make clean                       remove the generated files         '
+	@echo '   make regenerate                  regenerate files upon modification '
+	@echo '   make publish                     generate using production settings '
+	@echo '   make serve [PORT=8000]           serve site at http://localhost:8000'
+	@echo '   make devserver [PORT=8000]       start/restart develop_server.sh    '
+	@echo '   make stopserver                  stop local server                  '
+	@echo '   make ssh_upload                  upload the web site via SSH        '
+	@echo '   make rsync_upload                upload the web site via rsync+ssh  '
+	@echo '   make dropbox_upload              upload the web site via Dropbox    '
+	@echo '   make ftp_upload                  upload the web site via FTP        '
+	@echo '   make s3_upload                   upload the web site via S3         '
+	@echo '   make cf_upload                   upload the web site via Cloud Files'
+	@echo '   make github                      upload the web site via gh-pages   '
+	@echo '                                                                       '
+	@echo 'Set the DEBUG variable to 1 to enable debugging, e.g. make DEBUG=1 html'
+	@echo '                                                                       '
+
+html:
+	$(PELICAN) $(INPUTDIR) -o $(OUTPUTDIR) -s $(CONFFILE) $(PELICANOPTS)
+
+clean:
+	[ ! -d $(OUTPUTDIR) ] || rm -rf $(OUTPUTDIR)
+
+regenerate:
+	$(PELICAN) -r $(INPUTDIR) -o $(OUTPUTDIR) -s $(CONFFILE) $(PELICANOPTS)
+
+serve:
+ifdef PORT
+	cd $(OUTPUTDIR) && $(PY) -m pelican.server $(PORT)
+else
+	cd $(OUTPUTDIR) && $(PY) -m pelican.server
+endif
+
+devserver:
+ifdef PORT
+	$(BASEDIR)/develop_server.sh restart $(PORT)
+else
+	$(BASEDIR)/develop_server.sh restart
+endif
+
+stopserver:
+	kill -9 `cat pelican.pid`
+	kill -9 `cat srv.pid`
+	@echo 'Stopped Pelican and SimpleHTTPServer processes running in background.'
+
+publish:
+	$(PELICAN) $(INPUTDIR) -o $(OUTPUTDIR) -s $(PUBLISHCONF) $(PELICANOPTS)
+
+ssh_upload: publish
+	scp -P $(SSH_PORT) -r $(OUTPUTDIR)/* $(SSH_USER)@$(SSH_HOST):$(SSH_TARGET_DIR)
+
+rsync_upload: publish
+	rsync -e "ssh -p $(SSH_PORT)" -P -rvz --delete $(OUTPUTDIR)/ $(SSH_USER)@$(SSH_HOST):$(SSH_TARGET_DIR) --cvs-exclude
+
+dropbox_upload: publish
+	cp -r $(OUTPUTDIR)/* $(DROPBOX_DIR)
+
+ftp_upload: publish
+	lftp ftp://$(FTP_USER)@$(FTP_HOST) -e "mirror -R $(OUTPUTDIR) $(FTP_TARGET_DIR) ; quit"
+
+s3_upload: publish
+	s3cmd sync $(OUTPUTDIR)/ s3://$(S3_BUCKET) --acl-public --delete-removed
+
+cf_upload: publish
+	cd $(OUTPUTDIR) && swift -v -A https://auth.api.rackspacecloud.com/v1.0 -U $(CLOUDFILES_USERNAME) -K $(CLOUDFILES_API_KEY) upload -c $(CLOUDFILES_CONTAINER) .
+
+github: publish
+	ghp-import $(OUTPUTDIR)
+	git push origin gh-pages
+
+.PHONY: html help clean regenerate serve devserver publish ssh_upload rsync_upload dropbox_upload ftp_upload s3_upload cf_upload github
diff --git a/README.md b/README.md
@@ -1,4 +1,110 @@
-pythonclub.github.io
-====================
+[pythonclub.com.br][0]
+======================
 
 Blog colaborativo sobre tecnologias que envolvam a linguagem Python
+
+
+Como Contribuir
+---------------
+
+* Faça um fork desse repositório, clicando no botão [![Fork][14]][15], na parte superior direita da pagina do Github
+* Clone seu fork:
+
+    ``git clone --recursive https://github.com/SEU_USUARIO_DO_GITHUB/pythonclub.github.io.git``
+
+* Instale os requirements ``pip install -r requirements.txt``
+* Todas as publicações ficam na pasta ``content``, os textos podem ser escritos
+  no formato **[Markdown][4]** ou **[reStructuredText][5]**, fique a vontade
+  para usar o que você sentir mais afinidade, veja alguns **[exemplos][6]**.
+* Após criar ou editar seu artigo faça um pull-request para que ele seja
+  adicionado ao site.
+* Caso tenha dificuldades para escrever Markdown ou reStructuredText, veja esses editores online que auxiliam sua escrita: 
+  * [StackEdit][8]
+  * [Dillinger][9]
+  * [Prose][10]
+
+Não entendeu nada? Veja o video que explica o processo de fork, clone, push e pull-request : http://pythonclub.com.br/como-fazer-fork-clone-push-pull-request-no-github.html
+
+
+Sincronizando seu fork
+----------------------
+
+Caso você já tenha feito fork a algum tempo você tem duas opções para garantir que
+estará trabalhando com as ultimas alterações, que pode ser simplesmente deletar
+seu fork e fazer um novo ou sincronizar seu fork com o repositório de origem
+usando as [instruções contidas na wiki][11]
+
+
+
+Informações Técnicas
+--------------------
+
+O site pythonclub.com.br está sendo hospedado usando o **[Github Pages][1]**.
+
+O **[Github Pages][1]** hospeda arquivos HTML sem qualquer tipo de custo, bastando 
+que exista um repositório chamado ``seu-usuario.github.io`` 
+(Perceba que deve ser incluido o ``.github.io``).
+Os arquivos HTML devem ser incluidos no branch ``master`` para que o Github automaticamente
+publique aqueles arquivos HTML na web no endereço: ``http://seu-usuario.github.io``
+
+
+Para gerar os arquivos HTML, e visando a facilidade de escrever textos utilizando
+a linguagem de marcação [Markdown][11] e [reStructuredText][12], 
+utilizamos o **[Pelican][2]**, que é um projeto feito em Python.
+
+Como a branch ``master`` é usada internamente pelo Github para servir os
+arquivos HTML, criamos uma branch chamado ``pelican`` para armazenar os arquivos
+de configuração e as publicação em seu "estado-bruto".
+
+Essa branch está definida
+como padrão para o repositório e você possivelmente não precisará se preocupar
+com isso.
+
+
+Visualizando sua publicação antes de enviar
+-------------------------------------------
+
+O **Pelican** conta com algumas facilidades que permitem que você teste o site
+localmente na medida que você vai escrevendo o texto e antes de enviar para o
+servidor, inclusive vem com um script para facilitar isso.
+
+Para utilizar o script para iniciar basta
+executar o comando:
+
+``./develop_server.sh start``
+
+Então basta visitar o endereço [http://localhost:8000/][3]
+
+Para finalizar o servidor use:
+
+``./develop_server.sh stop``
+
+Futuras Publicações
+-------------------
+
+Alguns dos contribuidores criaram o compromisso de publicar alguns artigos.
+
+Foi estabelecido um prazo maximo para a entrega dos artigos com o intuito de que o contribuidor realmente publique o artigo com o conteudo que ele mesmo definiu.
+
+Você pode ver a lista contendo os nomes dos artigos nesta planilha no [Google Drive][7].
+
+Quando tiver um assunto e uma data de entrega, adicione na planinha, ao finalizar o seu artigo, envie o pull request e atualize a planilha marcando que sua publicação já foi entregue.
+
+
+[0]: http://pythonclub.com.br/
+[1]: https://pages.github.com/
+[2]: http://docs.getpelican.com/en/3.3.0/
+[3]: http://localhost:8000/
+[4]: https://guides.github.com/features/mastering-markdown/
+[5]: http://docutils.sourceforge.net/docs/user/rst/quickref.html
+[6]: https://github.com/pythonclub/pythonclub.github.io/tree/pelican/exemplos
+[7]: https://docs.google.com/spreadsheets/d/1sddA5pa5LcssPvibBYOHUujyfRpmL1zKw_-MSn784Tg/edit#gid=0
+[8]: https://stackedit-beta.herokuapp.com/ 
+[9]: http://dillinger.io/
+[10]: http://prose.io/
+[11]: https://github.com/pythonclub/pythonclub.github.io/wiki/Sincronizando-seu-fork-com-o-reposit%C3%B3rio-principal
+[12]: http://br-mac.org/2013/09/o-que-e-markdown.html
+[13]: http://pt.wikipedia.org/wiki/Restructuredtext
+[14]: https://github.com/pythonclub/pythonclub.github.io/raw/pelican/content/images/pythonclub_geral/fork_git_hub0_o.png
+[15]: https://github.com/pythonclub/pythonclub.github.io/fork
+[16]: https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet