Skip to content

marighella/cms

Repository files navigation

CMS - Marighella

![Carolos Marighella] (http://marighella.github.io/cms/images/logo.png)

O Marighella é uma iniciativa dedicada a empoderar coletivos, movimentos sociais e organizações populares através da tecnologia. O nome é uma homenagem ao revolucionário Carlos Marighella, o negro guerrilheiro que balançou o Brasil ao lutar contra as opressões sobre o povo.

O que é?

É um Gerenciador de Conteúdo (CMS) baseado em software livre e no conceito da tecnologia popular - tecnologia do povo para o povo. Pensada e construída nestes termos, a plataforma objetiva trabalhar com os desafios e características de iniciativas populares. Para tal, pretende ser leve, simples e deixar que os usuários foquem apenas na produção do conteúdo.

Como desenvolver?

Pré-requisitos:

Local

Github

Instalando dependências

Instalando os pacotes NodeJS

$ npm install

Instalando os pacotes do Frontend do projeto via Bower

$ bower install

Executando em sua máquina local

$ grunt serve

A aplicação será executada no endereço http://localhost:9000.

Como funciona?

O Gerenciador de Conteúdo (CMS) Marighella foi construído em AngularJS e é hospedado no Github Pages. Através da Github API, o conteúdo gerado é submetido para um repositório no Github através de um commit. Esse repositório, por sua vez, contém o Jekyll, marcações (HTML + CSS) e todas as postagens.

Para a publicação deste conteúdo, também usamos o Github Pages. Utilizando a API do Github o Marighella faz um commit para o repositório onde o usuário possui o site, se você estiver usando o Jekyll com geração automatica do github o resto é ele, caso não utilize o GH com geração de páginas automaticas, por qualquer motivo seja esse pluglins de terceiros, sugerimos que utilize algum Servidor de Integração para realizar uma implantação do conteudo.

Como colaborar?

Esta plataforma é levada a cabo por um time dedicado a melhorá-la constantesmente. Como vocês podem imaginar, o desafio é grande! Colaboração é a chave para nos manter-mos relevantes para mais e mais movimentos/organizações sociais.

Queremos (e precisamos) de ajuda para trabalhar no Marighella. Se você tem interesse em nos ajudar, em tirar alguma dúvida, em pegar mais contexto, fique a vontade para nos contactar. Qualquer um dos desenvolvedores deste repositório irá respondê-lo.

Também criamos uma box vagrant com todas as dependências necessárias para facilitar a vida de novos contribuidores que chamamos carinhosamente de Marighella-Box

Discussões Gitter chat

Para discussões relacionadas ao projeto, é utilizado o gitter que disponibiliza um chat em tempo real.

Gerenciamento de Projeto Stories in Ready

Throughput Graph

Para controle das funcionalidades, bugs, revisão de código e afins é utilizado o waffle que trabalha em cima das issues do github, e disponibiliza um painel para um controle maior.

Perguntas frequentes

1 - Eu não quero contribuir, eu quero utilizar o Marighella!

Ótimo só de usar o Marighella você já tá ajudando bastante. Para usar o Marighella, não é preciso "forkar" o projeto, só precisa acessar o link dele em produção e garantir estes pontos abaixo:

Ter uma conta no Github;

Ter ao menos um projeto que utilize o Jekyll na sua lista de repositórios do Github;

2 - Quando logo ele pede permissão para escrita nos repositórios, é de boa?

Sim, o Marighella executa 95% do trabalho em sua maquina os outros 5% é a chamada da biblioteca do GithubAPI para realizar e enviar o commit com o que foi feito.

3 - Quando eu clico em entrar e dou permissão no github não aparece nada.

O Marighella procura entre todos os seus projetos/organização algum repositório que tenha um jekyll hospedado, caso não tenha nenhum repositório com o Jekyll vai ficar dificil :/

4 - Quero contribuir no projeto, mas quando rodo ele localmente e tento enviar um rascunho ou uma publicação o meu navegador faz download do arquivo. Isto é um bug?

Não e pode ficar tranquilo. Caso o projeto não esteja rodando no ambiente de produção isso ocorrerá e é totalmente esperado. Caso queira alterar isso, basta alterar o valor do serviço de resource e colocar isProduction: true

Copyright (C) 2014 ThoughtWorks Brasil

About

O Gerenciador de conteúdo, do projeto Marighella, tem como objetivo empoderar movimentos sociais na Internet, permitindo-os focar apenas no conteúdo.

Resources

License

Stars

Watchers

Forks

Packages

No packages published