clagomess / pirilampo Goto Github PK
View Code? Open in Web Editor NEWThe open source living documentation generator of features files writen in Gherkin and Markdown support.
License: MIT License
The open source living documentation generator of features files writen in Gherkin and Markdown support.
License: MIT License
O versionamento de um arquivo que venha conter várias features não é interessante, mas isso podemos resolver através de instrução aos analistas. Já o versionamento atual, temos o problema de ser mantido em memória, apenas para geração do HTML.
Com isso propomos um versionamento utilizando um arquivo em cada pasta das funcionalidades, onde poderá conter o campo versão.
Neste arquivo poderá conter algumas outras informações, para a ferramenta utilizar no momento de aplicar a versão. Além do campo "Versão", os campos "Baseline" e "Release" são interessantes para o arquivo.
com.itextpdf.tool.xml.exceptions.RuntimeWorkerException: Invalid nested tag p fo
und, expected closing tag campo.
at com.itextpdf.tool.xml.XMLWorker.endElement(XMLWorker.java:135)
at com.itextpdf.tool.xml.parser.XMLParser.endElement(XMLParser.java:397)
at com.itextpdf.tool.xml.parser.state.ClosingTagState.process(ClosingTag
State.java:71)
at com.itextpdf.tool.xml.parser.XMLParser.parseWithReader(XMLParser.java
:237)
at com.itextpdf.tool.xml.parser.XMLParser.parse(XMLParser.java:215)
at com.itextpdf.tool.xml.parser.XMLParser.parse(XMLParser.java:176)
at com.itextpdf.tool.xml.XMLWorkerHelper.parseXHtml(XMLWorkerHelper.java
:239)
at com.itextpdf.tool.xml.XMLWorkerHelper.parseXHtml(XMLWorkerHelper.java
:211)
at com.itextpdf.tool.xml.XMLWorkerHelper.parseXHtml(XMLWorkerHelper.java
:243)
at br.com.pirilampo.util.ParsePdf.buildHtml(ParsePdf.java:27)
at br.com.pirilampo.util.Compilador.compilarPastaPdf(Compilador.java:301
)
at br.com.pirilampo.controller.MainController.lambda$pastaGerarPdf$19(Ma
inController.java:129)
at java.lang.Thread.run(Unknown Source)
.keyword{
font-weight: bold;
color: #337ab7;
float: left;
width: 60px;
text-align: right;
margin-right: 4px;
}
Para facilitar a forma de geração da EPE e matriz, a seleção prévia do campo " Gerar Documentação" deve ser realizada. Abaixo as condições:
Opção | Regra |
---|---|
Individual | Gera uma feature individual |
Coletiva | Gera todas as features da pasta selecionada |
Matriz | Gera apenas a matriz de rastreabilidade |
Conforme conversa com codificador, foi identificado que há possibilidade de criar comparação de duas features, ou duas pastas de features. Neste ponto, não sabemos como será o resultado final da forma de visualização, mas esta função seria bastante útil para leitura de documentações que foram manutenidas. Ficamos a disposição para alguma proposta para implementação desta função.
A matriz de rastreabilidade gerada deve conter duas páginas, com o mesmo layout utilizado na geração da EPE. A matriz será gerada na pasta "..\3 - Requisitos\Especificações", com isso, será possível utilizar informações de vários módulos e funcionalidades.
A matriz deverá gerar um arquivo único em formato HTML, localizado na pasta "..\3 - Requisitos\Matriz de Rastreabilidade". Caso não exista a pasta em questão, o sistema deverá cria-la.
A seguir as páginas que deverão ser criadas após a geração da matriz:
Regras Gerais
Nesta matriz, deve conter as regras gerais, que estão localizadas no arquivo feature "..\3 - Requisitos\Regras Gerais\RegrasGerais.feature". Cada cenário deste arquivo feature deve ser colocado nas seções, recuperando o título do cenário em cada um. Dentro da seção deve haver o texto do cenário, nesta feature os cenários não conterão exemplos, apenas um texto pré-definido e uma lista de funcionalidades.
Os cenários desta matriz estarão referenciados, em sequência, da seguinte forma:
Exemplo: @ref_rng01
Sendo assim, será possível recuperar todos os cenários presentes nas features da pasta "..\3 - Requisitos\Especificações" que tenham a tag @ref_rng01.
O sistema deverá recuperar o nome da funcionalidade, localizado no topo da feature após o campo:
Exemplo: "Funcionalidade: Incluir Pessoa"
E atribuir, com um link de pop up, o nome da funcionalidade e a opção de visualização do cenário original. Na exibição da pop up será exibido o cenário que citou a regra geral, conforme a imagem acima "Verificar Campos Obrigatórios".
Sendo assim, podemos criar a matriz de regras gerais da seguinte forma:
Regras de Negócio
Nesta matriz de regra de negócio deve conter os cenários de todas as features da pasta "..\3 - Requisitos\Especificações" que estão com a tag a seguir:
As seções desta página deverão conter o nome das pastas daquela feature.
Sendo assim, as seções devem estar descritas da seguinte forma:
A lista presente em cada seção deve estar preenchidas com as regras sinalizadas com a tag, ordenadas pela feature e numeração do cenário. As quatro primeiras regras do "Módulo" administrativo que podemos considerar estão na seguinte feature:
Os cenários são:
Sendo assim, podemos exemplificar essa matriz da seguinte forma:
Line 215 in beb1cb2
file:\D:\pirilampo\build\pirilampo.jar!\br\com\pirilampo\htmlTemplate\template_feature.html (A sintaxe do nome do arquivo, do nome do diretório ou do rótulo do volume está incorreta)
A forma de alteração de cores do documento dificulta o uso da ferramenta. A solução encontrada foi adicionar as seguintes cores pré-definidas para gerar o documento:
Cor | Código |
---|---|
Vermelho | #D50000 |
Rosa | #E67C73 |
Laranja | #F4511E |
Amarelo | #F6BF26 |
Verde Claro | #33B679 |
Verde | #0B8043 |
Anil | #039BE5 |
Azul | #3F51B5 |
Azul Claro | #7986CB |
Violeta | #8E24AA |
Cinza | #616161 |
Branco | #FFFFFF |
Preto | #040404 |
Personalizada | - |
O padrão de cores utilizado foi retirado da agenda do Google. Os domínios das combobox "Cor do Menu" e "Cor do Texto do Menu" irão exibir o nome da cor e ao gerar a documentação, o código da cor seria aplicado.
Ao selecionar o domínio " Personalizada " em algum dos campos, é exibido um input abaixo do respectivo campo para adicionar o código da cor. Este campo só deverá ser exibido na seleção desse domínio.
Eu quero fazer o seguinte dentro da descrição de um cenário, citar o nome de outro cenário e que o pirilampo crie um link, e quando eu clicar ele leve para o outro cenário ou que quando eu passe o mouse no link do cenário ele abra um hint apresentando o conteúdo
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.