limarka 0.6.2 → 0.6.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ee9a2ad0a20ddce9f9aa5d53f8ca050c90a76ea2
-  data.tar.gz: d8e086b75ed49ca6d3c8924243db6726d00862a1
+  metadata.gz: 682ef2210d24a2f441d629ee4f0547ba3f40190e
+  data.tar.gz: 3f7f0fb0ba55d52f1a08eac06f1717eb9591c71f
 SHA512:
-  metadata.gz: 6a9cecf6f1d48fcfd5797460d91316df35ff3b2b7c94e7f77a68452be1510fc433ffcc5681a33893931af44194dce461ba75a41598024c56f7ba4a318dc69672
-  data.tar.gz: a3ba8fc0f70a27a832fcb300cf1b18d90fc226c1669aa9fc7c4dafee34ded9a39a3103c88542ccbdad3617b28cf4db5c6ddf3fe94a1f366cf9e2985aa3883a7b
+  metadata.gz: 023f0ff0cb6bd608f644dba1ef5a34eb3ba63d531551d2edac01133aae7028dd3c02c498a9fbb2f17c1205a972b77064a0a5284fec6b6f1c7c55059ab57e1e71
+  data.tar.gz: 9f8025a8d7cc20d39ac5d9a3876c53fec20db9a7b6196e4198519bbb800897e8ef471705343851af9853546c434e8100ddd374795d6f18ddf25352249a0daf45

data/.travis.yml

@@ -5,15 +5,17 @@ rvm:
 - 2.3.1
 before_install:
 - sudo apt-get update -qq
-- sudo apt-get install -qq ruby-full pdftk xclip
-- wget https://github.com/jgm/pandoc/releases/download/1.19.1/pandoc-1.19.1-1-amd64.deb
-- sudo dpkg -i pandoc-1.19.1-1-amd64.deb
-- sudo apt-get install libreoffice
-deploy:
-  provider: rubygems
-  api_key:
-    secure: GorPgbfIdindE+uPZw0V3jJ8d1+bil0V4ac1Z5K+TPVd85oI2dynEbZa5hpMTVp8g+a3TztyfJucTv6aV8dUJ8ZcnkoAuyqrA7/618YWNt/x5ytUIbkH8g9hWlrLeG55DBwTMNSnZJeVDvMqTMm2rblU29+fo0+K9enjlPhWv+vV7sRuBGUKJ//uVOANo1gsrbOKKtf/mreZzToHaSNy1bbNe7GvvM9+N0Z/+BSh5wDs2Q5etPTai9GVbHf2yyzFrdQrW9D72i5tRWowi0O2DCqUxR+M3p1HUIB9ringNjrcY4PCHIt6TlzHVsTrcubFDIhEEu1Km+m+ZKbaGInjiwXR2392UQrOnhZGElFjNrXTRs+jdA4MH50jywsw7Ha+JhNirtTfTyuWcHkHbRVG4oG5dNgPzBCdeVy/mwLUOycSBlXJiXzL1fJASc4+H6ASTPzksf4I/yFAo+7KtIbwN2vfhCALEOy3iI5oZzY00DmQmHI/jhXGDWvr4MLH1p4HvyCx4JpdOZegoCaPp7wJGYbQk9c54Qdcvb80M/t88io5NYPVg5LLHqfJiOkZR5PJTWNq/mIlmGuHHuCFqpGYPbDorzFASptiirUe26smlD9v/izhjb68Cgg1BJi2InbSNVmowSIaQhUEFQO2WMhjq18J0bv/rpyE988dHp6hzpE=
-  gem: limarka
-  on:
-    tags: true
-    repo: abntex/limarka
+- sudo apt-get install -y -qq ruby-full pdftk xclip poppler-utils language-pack-pt libreoffice
+- wget https://github.com/jgm/pandoc/releases/download/1.19.1/pandoc-1.19.1-1-amd64.deb && sudo dpkg -i pandoc-1.19.1-1-amd64.deb
+- wget http://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz && tar -xf install-tl-unx.tar.gz && cd install-tl-* && sudo ./install-tl -no-gui -profile ../spec/dependencias/texlive-abntex2.profile -no-verify-downloads && cd ..
+- export PATH=$PATH:/usr/local/texlive/2016/bin/x86_64-linux
+script:
+- latexmk -v
+- xelatex -v
+- pdftotext -v
+- pandoc -v
+- libreoffice --version
+- bundle exec rake
+- bundle exec rake spec:latex
+after_failure:
+- cd /usr/local/texlive && find . -iname latexmk

data/CHANGELOG.md

@@ -1,11 +1,32 @@
 # Change Log
 
+## [v0.6.3](https://github.com/abntex/limarka/tree/v0.6.3) (2017-01-15)
+[Full Changelog](https://github.com/abntex/limarka/compare/v0.6.2...v0.6.3)
+
+**Melhorias implementadas:**
+
+- Fazer os testes Latex passarem no travis [\#113](https://github.com/abntex/limarka/issues/113)
+- Tornar a ajuda \(o wiki\) acessível off-line [\#105](https://github.com/abntex/limarka/issues/105)
+- Melhorias de navegação no Wiki [\#101](https://github.com/abntex/limarka/issues/101)
+
+**Bugs corrigidos:**
+
+- Erro quando há espaço no path do diretório no Windows [\#117](https://github.com/abntex/limarka/issues/117)
+
+**Issues fechados:**
+
+- Apresentar a ferramenta utilizando gif animados [\#114](https://github.com/abntex/limarka/issues/114)
+- Write a better CONTRIBUTING and README [\#99](https://github.com/abntex/limarka/issues/99)
+- Software paper writing [\#94](https://github.com/abntex/limarka/issues/94)
+- Several actions related to the software paper [\#93](https://github.com/abntex/limarka/issues/93)
+- Comunicar a equipe do abntex sobre o lançamento do limarka [\#66](https://github.com/abntex/limarka/issues/66)
+
 ## [v0.6.2](https://github.com/abntex/limarka/tree/v0.6.2) (2017-01-09)
 [Full Changelog](https://github.com/abntex/limarka/compare/v0.6.1...v0.6.2)
 
 **Bugs corrigidos:**
 
-- problema no windows [\#115](https://github.com/abntex/limarka/issues/115)
+- Falta do gem ffi causa problema no Windows [\#115](https://github.com/abntex/limarka/issues/115)
 
 ## [v0.6.1](https://github.com/abntex/limarka/tree/v0.6.1) (2017-01-08)
 [Full Changelog](https://github.com/abntex/limarka/compare/v0.6.0...v0.6.1)

data/CONTRIBUTING.md

@@ -1,14 +1,19 @@
-# Experimento
+# Contribuindo com o projeto
 
 No momento, as maiores contribuições são: utilizar a ferramenta, [realizar o experimento]
 e [divulgá-la](https://github.com/abntex/limarka/wiki/Imprensa).
 
 [realizar o experimento]: https://github.com/abntex/limarka/wiki/Experimentos
 
+Pull requests são sempre bem vindos. Ao participar desse projeto você está de 
+acordo com o [código de conduda].
+
 O projeto tem como origem uma pesquisa científica (em andamento) sobre utilização de linguagem de marcação de texto para elaboração de monografias.
 
 - [Realize o experimento de utilização](https://github.com/abntex/limarka/wiki/Experimentos)
 
+Acesse o [chat no gitter](http://gitter.im/abntex/limarka) e fale conosco, independente do seu perfil.
+
 # Professor
 
 Como professor você pode contribuir com o limarka divulgando-o e ofertando o limarka como uma opção para seus alunos realizarem tarefas. 
@@ -35,13 +40,9 @@ Como professor você pode contribuir com o limarka divulgando-o e ofertando o li
 - Escreva seu trabalho de conclusão ou sua proposta/projeto com o limarka e compartilhe sua experiência
 - Clique na estrela [no repositório do projeto](https://github.com/abntex/limarka) (equivale a um *like*) no github.
 
-# Designer
-
-- [Precisamos de ajuda para criar um logotipo para o projeto](https://github.com/abntex/limarka/issues/102).
-
 # Usuário Latex
 
-TODO.
+Gostaríamos de converter as [customizações conhecidas do abnTeX2](https://github.com/abntex/abntex2/wiki/CustomizacoesConhecidas) para utilização com o limarka.
 
 # Desenvolvedor Ruby
 
@@ -53,6 +54,20 @@ Ao participar desse projeto você está de acordo com o [código de conduda].
 
 [código de conduda]: https://github.com/abntex/limarka/blob/master/CODE_OF_CONDUCT.md
 
+# Desenvolvedor WEB
+
+Nós desejamos melhorar a experiência de utilização da ferramenta implementando 
+um site que gere conteúdos dinâmicos.
+
+Suponha que um usuário deseja adicionar uma referência de um artigo, gostaria
+que o usuário clicasse em "Artigo" e um formulário fosse apresentado para 
+preenchimento e acordo com os campos bib desse tipo de entrada. Quando o usuário
+vai preenchendo o código bib é gerado automaticamente para inserção no arquivo
+de referências.
+
+Para compreender a funcionalidade veja o site [http://shields.io](http://shields.io/) e clique em algum dos badges.
+
+
 ## Implementando uma nova funcionalidade
 
 [Crie um issue](https://github.com/abntex/limarka/issues/new) descrevendo a nova funcionalidade.

data/README.md

@@ -10,8 +10,7 @@ Olá! Bem vindo ao limarka!
 
 O limarka é uma ferramenta que possibilita seus usuários escreverem relatórios ou trabalhos de conclusão de curso (Monografia, TCC, Dissertação ou Tese) em arquivos somente texto e **produzir PDFs em conformidades com as Normas da ABNT**. A produção desse tipo de trabalho é um momento sensível na vida dos estudantes, que pode contribuir para evasão no ensino superior. O objetivo do limarka é liberar dos estudantes os esforços de formatação e adequação às Normas da ABNT, deixando-os concentrar-se no planejamento, execução e escrita de seus trabalhos.
 
-
-# Especificidades do limarka
+# Quem utiliza o limarka diz que ele é fácil e prazeroso, descubra o porquê!
 
 <!-- Explain what makes your project special, useful, exciting! -->
 
@@ -22,12 +21,16 @@ O limarka é uma ferramenta que possibilita seus usuários escreverem relatório
 * Permite a escrita do trabalho em arquivos somente texto, utilizando Markdown
 * As configurações são realizadas em um arquivo de formulário em PDF
 
+## Exemplo de utilização do limarka
+
+![logo](https://raw.githubusercontent.com/wiki/abntex/limarka/imagens/escrevendo-objetivos-em-markdown.gif)
+
 # Como iniciar utilização
 
 <!-- Show how to get started using or contribution to the project -->
 
-- [Veja se o visual do PDF gerado com a ferramenta lhe satisfaz](https://github.com/abntex/trabalho-academico-limarka/releases/download/v0.2.0/xxx-Monografia-projeto.pdf)
 - [Para começar a utilizar a ferramenta siga as instruções no wiki do projeto](https://github.com/abntex/limarka/wiki)
+- Lembre-se de acessar o [chat no gitter](http://gitter.im/abntex/limarka) para tirar suas dúvidas sobre a ferramenta.
 
 # Contribuindo com o projeto
 
@@ -57,13 +60,22 @@ Veja como é fácil contribuir!
 
 - Auxilie na criação de templates latex customizados para as instituições
 
-## Desenvolvedor Ruby 
+## Desenvolvedor Ruby
 
 [![GitHub issues](https://img.shields.io/github/issues/abntex/limarka.svg)](https://github.com/abntex/limarka/issues)
 
 - [Escolha uma das funcionalidades para implementar](https://github.com/abntex/limarka/issues)
 - Notifique ou corrija um Bug
 
+Acesse o [chat no gitter](http://gitter.im/abntex/limarka) e fale conosco!
+
+## Desenvolvedor Web
+
+Nós desejamos melhorar a experiência de utilização da ferramenta implementando 
+um site que gere conteúdos dinâmicos, gostaria de contribuir? 
+
+Acesse o [chat no gitter](http://gitter.im/abntex/limarka) e fale conosco!
+
 ## Todas as formas de contribuição
 
 Consulte o arquivo [CONTRIBUTING.md](CONTRIBUTING.md) para verificar todas as formas de contribuições.
@@ -72,7 +84,7 @@ Consulte o arquivo [CONTRIBUTING.md](CONTRIBUTING.md) para verificar todas as fo
 
 ## Deseja entrar em contato?
 
-O meio de comunicação oficial do limarka é uma sala de bate papo no gitter: [![Join the chat at https://gitter.im/abntex/limarka](https://badges.gitter.im/abntex/limarka.svg)](https://gitter.im/abntex/limarka?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+O meio de comunicação oficial do limarka é uma sala de bate papo no gitter: [![Join the chat at https://gitter.im/abntex/limarka](https://badges.gitter.im/abntex/limarka.svg)](https://gitter.im/abntex/limarka)
 
 # Links
 
@@ -80,42 +92,16 @@ O meio de comunicação oficial do limarka é uma sala de bate papo no gitter: [
 - [Vídeos](https://www.youtube.com/playlist?list=PLTnAY6TvPRKK6OgGYy3UA0oFdfCfRZesY) -- recomendo assistir em velocidade rápida
 - [Convite para realização de experimento de utilização](https://github.com/abntex/limarka/wiki/Experimentos)
 
-# Por que escrever em Markdown em vez de Latex?
-
-O LaTeX é ótimo e bastante útil para quem deseja percorrer uma carreira de Pesquisador. Muitos *journals* disponibilizam modelos somente em LaTeX para produção de artigos, aprender LaTeX irá ser útil nessa carreira. Mas se você não pretende utilizar LaTeX após a conclusão do seu curso, por que investir na longa curva de aprendizado do LaTeX?
-
-Com o limarka você agora possui outra alternativa de investimento: *aprender Markdown* (que é bastante simples).
-
-O [Markdown](https://pt.wikipedia.org/wiki/Markdown) é uma [linguagem simples de marcação](https://en.wikipedia.org/wiki/Lightweight_markup_language). Os princípios das linguagem simples de marcação estão sendo popularizados em diversas ferramentas de interação social, veja alguns exemplos: [Github](https://help.github.com/articles/basic-writing-and-formatting-syntax/), [Moodle](https://docs.moodle.org/23/en/Markdown), [WhatsApp](https://www.whatsapp.com/faq/en/general/26000002), [Facebook](http://wersm.com/facebook-is-testing-rich-text-formatting-with-markdown/) [Google Plus](https://plus.google.com/+SarahHill/posts/TWYwPctEpJp), [Jekyll](http://jekyllrb.com), etc.
-
-Após ou durante conclusão do seu curso, você pretende:
-
-- Interagir através da escrita em redes sociais ou fóruns de discussão?
-- Editar Wikis ou formatar mensagens?
-- Participar em projetos no Github?
-- Escrever documentações de softwares?
-- Gerar código HTML a partir de texto?
-- Elaborar *ebooks*?
-
-Se você respondeu afirmativamente a algumas dessas perguntas, aprender uma linguagem simples de marcação (como o Markdown) é um investimento rentável.
-
-**OBS:** A implementação atual do limarka ainda exige conhecimentos mínimos do Latex.
-
-# Qual a relação do limarka com o abnTeX?
-
-O [abnTeX](https://github.com/abntex) provém  uma suíte para LaTeX que atende os requisitos das normas da ABNT (Associação Brasileira de Normas Técnicas) para elaboração de trabalhos acadêmicos como teses, dissertações, projetos de pesquisa e outros documentos do gênero.
-
-O limarka converte os textos produzidos em Markdown para LaTeX, utilizando os modelos do abnTeX2 (que são extensivamente testados e incrementados pela comunidade nacional), produzindo um PDF em conformidade com as Normas da ABNT. O limarka é um projeto pertencente ao grupo do [abnTeX](https://github.com/abntex).
-
-# Funcionalidades
+# Funcionalidades do limarka
 
 - Utilização da linguagem Markdown para escrita do texto;
 - Configurações através de formulário PDF ou arquivo YAML;
 - Possibilidade de inclusão de códigos Latex;
-- Facilidade para geração de códigos para inclusão de Figuras, Tabelas, Referências e Citações;
+- Facilidade para geração de códigos para inclusão de Figuras, Quadros, Tabelas, Referências e Citações;
 - Facilidade em edição ou personalização de templates;
 - Facilidade de obter suporte ao código Latex gerado (compatível com o estilo do abnTeX2);
 
 # License
 
 Esse gem é disponibilizado como software livre através da [Licença MIT](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -10,16 +10,15 @@ require 'pdf_forms'
 require 'github_changelog_generator/task'
 
 
-desc 'Executa os testes com compilação Latex'
-RSpec::Core::RakeTask.new('spec:latex') do |t|
-  t.rspec_opts = "--tag compilacao"
-end
-
+desc 'Executa os testes ruby'
 RSpec::Core::RakeTask.new('spec') do |t|
-  # Enquanto os testes latex não estiverem passando no travis eles estão removidos daqui.
-  t.rspec_opts = "--tag ~compilacao"
+  t.rspec_opts = "--tag ~compilacao --tag ~dependencias_latex" 
 end
 
+desc 'Executa os testes com compilação Latex'
+RSpec::Core::RakeTask.new('spec:latex') do |t|
+  t.rspec_opts = "--tag compilacao --tag dependencias_latex"
+end
 
 task :default => [:configuracao_padrao, 'spec']
 

data/docs/paper/codemeta.json

@@ -0,0 +1,23 @@
+{
+  "@context": "https://raw.githubusercontent.com/mbjones/codemeta/master/codemeta.jsonld",
+  "@type": "Code",
+  "author": [
+    {
+      "@id": "http://orcid.org/0000-0002-9165-9438",
+      "@type": "Person",
+      "email": "eduardo.ufpb@gmail.com",
+      "name": "Eduardo de Santana Medeiros Alexandre",
+      "affiliation": "Universidade Federal da Paraíba"
+    }
+  ],
+  "identifier": "",
+  "codeRepository": "https://github.com/abntex/limarka",
+  "datePublished": "2016-12-08",
+  "dateModified": "2016-12-08",
+  "dateCreated": "2016-12-08",
+  "description": "Limarka makes possible to write dissertation and thesis with Markdown and produces PDFs according to Brazilian's ABNT standard.",
+  "keywords": "limarka,ABNT,markdown,dissertation,thesis",
+  "license": "MIT",
+  "title": "limarka",
+  "version": "v0.5.1"
+}

data/docs/paper/generate

@@ -0,0 +1,146 @@
+#!/usr/bin/ruby
+
+# For an OO language, this is distinctly procedural. Should probably fix that.
+require 'json'
+
+details = Hash.new({})
+
+capture_params = [
+  { :name => "title", :message => "Enter project name." },
+  { :name => "url", :message => "Enter the URL of the project repository." },
+  { :name => "description", :message => "Enter the (short) project description." },
+  { :name => "license", :message => "Enter the license this software shared under. (hit enter to skip)\nFor example MIT, BSD, GPL v3.0, Apache 2.0" },
+  { :name => "doi", :message => "Enter the DOI of the archived version of this code. (hit enter to skip)\nFor example http://dx.doi.org/10.6084/m9.figshare.828487" },
+  { :name => "keywords", :message => "Enter keywords that should be associated with this project (hit enter to skip)\nComma-separated, for example: turkey, chicken, pot pie" },
+  { :name => "version", :message => "Enter the version of your software (hit enter to skip)\nSEMVER preferred: http://semver.org e.g. v1.0.0" }
+]
+
+puts "I'm going to try and help you prepare some things for your JOSS submission"
+puts "If all goes well then we'll have a nice codemeta.json file soon..."
+puts ""
+puts "************************************"
+puts "*    First, some basic details     *"
+puts "************************************"
+puts ""
+
+# Loop through the desired captures and print out for clarity
+capture_params.each do |param|
+  puts param[:message]
+  print "> "
+  input = gets
+
+  details[param[:name]] = input.chomp
+
+  puts ""
+  puts "OK, your project has #{param[:name]}: #{input}"
+  puts ""
+end
+
+puts ""
+puts "************************************"
+puts "*        Experimental stuff        *"
+puts "************************************"
+puts ""
+
+puts "Would you like me to try and build a list of authors for you?"
+puts "(You need to be running this script in a git repository for this to work)"
+print "> (Y/N)"
+answer = gets.chomp
+
+case answer.downcase
+when "y", "yes"
+
+  # Use git shortlog to extract a list of author names and commit counts.
+  # Note we don't extract emails here as there's often different emails for
+  # each user. Instead we capture emails at the end.
+
+  git_log = `git shortlog --summary --numbered --no-merges`
+
+  # ["252\tMichael Jackson", "151\tMC Hammer"]
+  authors_and_counts = git_log.split("\n").map(&:strip)
+
+  authors_and_counts.each do |author_count|
+    count, author = author_count.split("\t").map(&:strip)
+
+    puts "Looks like #{author} made #{count} commits"
+    puts "Add them to the output?"
+    print "> (Y/N)"
+    answer = gets.chomp
+
+    # If a user chooses to add this author to the output then we ask for some
+    # additional information including their email, ORCID and affiliation.
+    case answer.downcase
+    when "y", "yes"
+      puts "What is #{author}'s email address? (hit enter to skip)"
+      print "> "
+      email = gets.chomp
+
+      puts "What is #{author}'s ORCID? (hit enter to skip)"
+      puts "For example: http://orcid.org/0000-0000-0000-0000"
+      print "> "
+      orcid = gets.chomp
+
+      puts "What is #{author}'s affiliation? (hit enter to skip)"
+      print "> "
+      affiliation = gets.chomp
+
+
+      details['authors'].merge!(author => { 'commits' => count,
+                                            'email' => email,
+                                            'orcid' => orcid,
+                                            'affiliation' => affiliation })
+
+    when "n", "no"
+      puts "OK boss..."
+      puts ""
+    end
+  end
+when "n", "no"
+  puts "OK boss..."
+  puts ""
+end
+
+puts "Reticulating splines"
+
+5.times do
+  print "."
+  sleep 0.5
+end
+
+puts ""
+puts "Generating some JSON goodness..."
+
+# TODO: work out how to use some kind of JSON template here.
+# Build the output list of authors from the inputs we've collected.
+output_authors = []
+
+details['authors'].each do |author_name, values|
+  entry = {
+    "@id" => values['orcid'],
+    "@type" => "Person",
+    "email" => values['email'],
+    "name" => author_name,
+    "affiliation" => values['affiliation']
+  }
+  output_authors << entry
+end
+
+# TODO: this is currently a static template (written out here). It would be good
+# to do something smarter here.
+output = {
+  "@context" => "https://raw.githubusercontent.com/mbjones/codemeta/master/codemeta.jsonld",
+  "@type" => "Code",
+  "author" => output_authors,
+  "identifier" => details['doi'],
+  "codeRepository" => details['url'],
+  "datePublished" => Time.now.strftime("%Y-%m-%d"),
+  "dateModified" => Time.now.strftime("%Y-%m-%d"),
+  "dateCreated" => Time.now.strftime("%Y-%m-%d"),
+  "description" => details['description'],
+  "keywords" => details['keywords'],
+  "license" => details['license'],
+  "title" => details['title'],
+  "version" => details['version']
+}
+
+File.open('codemeta.json', 'w') {|f| f.write(JSON.pretty_generate(output)) }

data/docs/paper/open-canvas.md

@@ -0,0 +1,86 @@
+# Open Canvas
+
+**Project**: [limarka](https://github.com/abntex/limarka)
+
+<!-- See http://mozillascience.github.io/working-open-workshop/writing_readme/ -->
+
+# Problem
+
+<!-- The Top 1-3 problems you want to solve -->
+
+1. Saber as Normas da ABNT atuais
+2. Saber como implementar as normas da ABNT atuais no editor (Configuração de Páginas, seções, estilos, formatação, sumário, apêndices, anexos, etc.)
+3. Manter consistente as citações e referências no documento.
+
+
+# Solution
+
+<!--  -->
+
+1. Exigir conhecimentos mínimos sobre as normas ABNT.
+2. Modelo com estilos pré-configurados e de fácil utilização.
+3. Sistema para gerenciamento de citações e elaboração das referências automaticamente.
+
+# Key Metrics
+
+<!-- How will you mesure success? -->
+
+- [Estrelas do projeto](https://github.com/abntex/limarka/stargazers)
+- Tráfegos de acesso no github: [limarka](https://github.com/abntex/limarka/graphs/traffic), [trabalho-academico-limarka
+](https://github.com/abntex/trabalho-academico-limarka
+/graphs/traffic)
+- [Notificações de trabalhos escritos com o limarka](https://github.com/abntex/limarka/wiki/M%C3%A9tricas)
+
+# Unique Value Proposition
+
+<!--  -->
+
+- O documento é escrito e formatado facilmente utilizando marcações no texto
+- Não exige conhecimentos técnicos para configuração, que é realizada através do preenchimento de um formulário PDF
+- Ótimo visual do documento de apresentação, pois é baseado no modelo Latex de trabalhos acadêmicos mantido pela comunidade abnTeX.
+- Solução Gratuita, software livre.
+
+# User profiles
+
+<!--  -->
+<!-- target audience and early adopters -->
+
+- Alunos com conhecimentos técnicos de informática que precisam escrever relatórios ou trabalhos de conclusão.
+- Mestrandos em computação/informática que precisam escrever a dissertação. (*early adopters*)
+
+# User channels
+
+<!--  -->
+
+- Instruções das coordenações/instituições para produção dos trabalhos acadêmicos sugerindo utilização do limarka.
+- Instruções de tarefas submetidas aos alunos/aprendentes sugerindo utilização do limarka.
+- Páginas pessoais/institucionais de professores.
+- Listas de discussões de alunos universitários.
+- Publicidade nas agências de noticias universitárias.
+
+# Resources required
+
+<!--  -->
+- Sistema para conversão de Markdown para Latex;
+- Templates Latex para produção de trabalhos de conclusão em conformidade com as Normas da ABNT;
+- Desenvolvedor ruby;
+- Estrutural inicial de trabalho de conclusão de curso;
+- Câmera e Microfone: gravação de vídeos para o canal.
+
+# Contributor Profiles
+
+<!-- Contributor types and ideal contributors -->
+
+- Professores que solicitam trabalhos/relatórios aos alunos
+- Orientadores que desejam otimizar o tempo de discussões metodológicas com seus orientandos
+- Estudantes de informática que desejam produzir os trabalhos com agilidade
+- Usuários Latex que desejam elaborar novos templates
+- Desenvolvedores Ruby que desejam implementar novas funcionalidades
+
+# Contributor Channels
+
+<!--  -->
+
+- [Publicidade nas agências de noticias universitárias](https://github.com/abntex/limarka/wiki/Imprensa)
+- [CONTRIBUTING.md no repositório do projeto](https://github.com/abntex/limarka/blob/master/CONTRIBUTING.md)
+- [Canal do limarka Youtube](https://www.youtube.com/channel/UC4kERewtyT_nw__YHbKMdBA)

data/docs/paper/paper.bib

@@ -0,0 +1,40 @@
+@online{Pandoc,
+  author = {John MacFarlane},
+  title = {Pandoc a universal document converter},
+  year = 2007,
+  url = {http://pandoc.org},
+  urldate = {2016-12-08}
+}
+
+@online{abnTeX2,
+  author = {abnTeX},
+  title = {Classe LaTeX e estilo bibliográfico compatíveis com as normas da ABNT},
+  year = 2016,
+  url = {http://www.abntex.net.br},
+  urldate = {2016-12-08}
+}
+
+@online{YAML,
+  author = {YAML},
+  title = {YAML Ain't Markup Language},
+  year = 2001,
+  url = {http://yaml.org},
+  urldate = {2016-12-08}
+}
+
+
+@online{form,
+  author = {Richard Foersom},
+  title = {Create PDF Forms with LibreOffice},
+  year = 2016,
+  url = {http://foersom.com/org/HowTo/CreatePdfForm.html},
+  urldate = {2016-12-08}
+}
+
+@manual{NBR14724:2011,
+	Address = {Rio de Janeiro},
+	Org-Short = {ABNT},
+	Organization = {Associa{\c c}\~ao Brasileira de Normas T\'ecnicas},
+	Pages = 15,
+	Title = {{NBR} 14724},
+  Year = 2011}

data/docs/paper/paper.md

@@ -0,0 +1,38 @@
+---
+title: 'Limarka: making possible Brazilian students writing dissertation and thesis with Markdown'
+tags:
+  - limarka
+  - markdown
+  - writing
+  - dissertation
+  - thesis
+  - abnt
+authors:
+ - name: Eduardo S M Alexandre
+   orcid: 0000-0002-9165-9438
+   affiliation: 1
+affiliations:
+ - name: Universidade Federal da Paraíba
+   index: 1
+date: 15 January 2017
+bibliography: paper.bib
+---
+
+# Summary
+
+Many Brazilian's students have to write Monograph, Dissertation or Thesis at the
+end of their course. But these documents must be written according to Brazilian's 
+@NBR14724:2011 standard (ABNT). Despite the fact that this standard is not public available 
+(it's for sale), it changes over time and has many rules.
+
+Limarka makes possible to produce these documents according to ABNT standard,
+by writing it with Markdown. Where the Markdown syntax is not expressive enough 
+to follow ABNT rules, the user will need to input Latex code, and limarka 
+makes it easier.
+
+Limarka uses @pandoc to convert documents from Markdown to Latex, but uses custom
+templates based on @abnTeX2 and configuration is done by filling a PDF @form, 
+instead of editing files with @YAML format.
+
+# References
+

data/lib/limarka/cli.rb

@@ -284,7 +284,8 @@ TEX
         when "rascunho"
           system "limarka", "exec", "--rascunho=rascunho.md"
         else
-          "You gave me #{cmd} -- I have no idea what to do with that."
+          "Você digitou a opção #{cmd} -- esta não é uma opção válida, apresentando o menu.\n"
+          puts table
         end
       end
 

data/lib/limarka/conversor.rb

@@ -80,7 +80,7 @@ module Limarka
       "epigrafe", "resumo", "abstract", "lista_ilustracoes", "lista_tabelas", 
       "lista_siglas", "lista_simbolos", "sumario"].each_with_index do |secao,indice|
         template = "pretextual#{indice+1}-#{secao}"
-        Open3.popen3("pandoc -f markdown --data-dir=#{options[:templates_dir]} --template=#{template} -t latex") {|stdin, stdout, stderr, wait_thr|
+        Open3.popen3("pandoc -f markdown \"--data-dir=#{options[:templates_dir]}\" --template=#{template} -t latex") {|stdin, stdout, stderr, wait_thr|
           stdin.write(hash_to_yaml(t.configuracao))
           stdin.write("\n")
           if t.errata? and necessita_de_arquivo_de_texto.include?(secao) then
@@ -140,7 +140,7 @@ module Limarka
     def secao(template, condicao_para_conteudo, conteudo_externo)
       s = StringIO.new
       
-      Open3.popen3("pandoc -f markdown --data-dir=#{options[:templates_dir]} --template=#{template} --chapter -t latex") {|stdin, stdout, stderr, wait_thr|
+      Open3.popen3("pandoc -f markdown \"--data-dir=#{options[:templates_dir]}\" --template=#{template} --chapter -t latex") {|stdin, stdout, stderr, wait_thr|
         stdin.write(hash_to_yaml(t.configuracao))
         stdin.write("\n")
         if (condicao_para_conteudo) then
@@ -176,7 +176,7 @@ module Limarka
     
     def textual(pretextual_tempfile, postextual_tempfile)
       valida_yaml
-      Open3.popen3("pandoc -f markdown+raw_tex -t latex -s --data-dir=#{options[:templates_dir]} --template=trabalho-academico --normalize --chapter --include-before-body=#{pretextual_tempfile.path}  --include-after-body=#{postextual_tempfile.path}") {|stdin, stdout, stderr, wait_thr|
+      Open3.popen3("pandoc -f markdown+raw_tex -t latex -s \"--data-dir=#{options[:templates_dir]}\" --template=trabalho-academico --normalize --chapter --include-before-body=#{pretextual_tempfile.path}  --include-after-body=#{postextual_tempfile.path}") {|stdin, stdout, stderr, wait_thr|
         stdin.write(File.read(options[:templates_dir] + '/templates/configuracao-tecnica.yaml'))
         stdin.write("\n")
         stdin.write(hash_to_yaml(t.configuracao))

data/lib/limarka/version.rb

@@ -1,3 +1,3 @@
 module Limarka
-  VERSION = "0.6.2"
+  VERSION = "0.6.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: limarka
 version: !ruby/object:Gem::Version
-  version: 0.6.2
+  version: 0.6.3
 platform: ruby
 authors:
 - Eduardo de Santana Medeiros Alexandre
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-01-09 00:00:00.000000000 Z
+date: 2017-01-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -219,6 +219,11 @@ files:
 - bin/setup
 - bin/test
 - configuracao.odt
+- docs/paper/codemeta.json
+- docs/paper/generate
+- docs/paper/open-canvas.md
+- docs/paper/paper.bib
+- docs/paper/paper.md
 - errata.md
 - exe/limarka
 - imagens/configuracao/agradecimentos.png