Code Monkey home page Code Monkey logo

afc2md's Introduction

afc2md

Conversor de .afc (Tubaina) para .md (Markdown) no sabor do Gitbook, com algumas pitadas do plugin gitbook-plugin-cdc. Pronto para ser usado com o tubaina2.

Como executar

Gerando o jar

Você vai precisar dos seguintes pré-requisitos:

  • Java JDK 1.7+
  • Maven

Baixe o projeto e execute mvn package. Será gerado o afc2md-1.0.0.jar na pasta target.

Executando

Execute o comando:

java -jar afc2md-1.0.0.jar -d /diretorio/onde/estao/os/afcs

A opção -d deve ser utilizada para informar o diretório onde estão os arquivos .afc que serão convertidos em .md. Caso essa opção seja omitida, será considerado o diretório corrente.

E pronto! Os arquivos .md devem ter sido gerados!

Também devem ter sido gerados como arquivos auxiliares como package.json, book.properties, cover.jpg, .bookignore e .gitignore. Todos são arquivos importantes para o tubaina2.

Usando o tubaina2

Para informaçoes sobre como usar o tubaina2 para gerar um site ou ebooks nos formatos .pdf, .mobi ou .epub, veja: https://github.com/caelum/tubaina2

Conversões realizadas

São feitas as seguintes conversões:

  • Capítulos como [chapter Eclipse IDE] viram # Eclipse IDE

  • Seções como [section Como aprender Java?] viram ## Como aprender Java?

  • Títulos como [title Aprendendo a aprender] viram ### Aprendendo a aprender

  • Texto em itálico como ::primary key:: viram _primary key_

  • Códigos inline como %%alert("Oi")%% viram `alert("Oi")`

  • Imagens como [img imagens/logo.png w=80% "Logo da empresa"] viram ![Logo da empresa {w=90%}](imagens/logo.png)

  • Tarefas como [TODO melhorar texto] viram <!--@todo melhorar texto -->

  • Notas para instrutores como

      [note]
          Mostre também a outra solução.
      [/note]
    

    viram

    <!--@note 
    Mostre também a outra solução.
     -->
    
  • Citações como [quote "Olho por olho, eo mundo acabará cego." -- Ghandi] viram _"Olho por olho, eo mundo acabará cego." -- Ghandi_

  • Uma lista do tipo

      [list]
      * responder o que é Java;
      * mostrar as vantagens e desvantagens do Java;\n"+
      * entender bem o conceito de máquina virtual;\n"+
      * compilar e executar um programa simples.\n"+
      [/list]
    

    vira

      * responder o que é Java;
      * mostrar as vantagens e desvantagens do Java;\n"+
      * entender bem o conceito de máquina virtual;\n"+
      * compilar e executar um programa simples.\n"+
    

Listas como [list number], [list letter] e [list #] viram a mesma coisa, sem suporte a números ou letras.

  • Exercícios, que começam com [exercise] são simplesmente removidos

  • Questões de exercícios como

     [question]
         Em WebContent, através do menu File -> New -> Other -> HTML crie um arquivo chamado index.xhtml.
     [/question]
     [question]
         Implemente nosso primeiro código JSF com um campo de texto e um botão.
     [/question]
    

    viram listas numeradas como

     1. Em WebContent, através do menu File -> New -> Other -> HTML crie um arquivo chamado index.xhtml.
     1. Implemente nosso primeiro código JSF com um campo de texto e um botão.
    

Linhas consecutivas mantém apenas um nível de TAB, exceto em códigos. Não deve existir mais de um ENTER entre linhas consecutivas.

  • Respostas de exercício como

    [answer]
        42
    [/answer]
    

    viram

    <!--@answer 
        42
    -->
    
  • Caixas de texto como

    [box Git e Github são a mesma coisa?]
        Não.
    [/box]
    

    viram

    > **Git e Github são a mesma coisa?**
    > Não.
    

Se houver um rótulo para o box, como no exemplo anterior, a primeira linha contém o rótulo em negrito. Linhas consecutivas mantém apenas um nível de TAB, exceto em códigos. Não pode existir mais de um ENTER entre as linhas do box. Dois box consecutivos devem ser separados com um comentário HTML, para não serem unificados.

  • Código como

    [code java]
        public class Main {
            public static void main(String... args){
            }
        }
    [/code]
    

    viram

    ``` java
        public class Main {
            public static void main(String... args){
            }
        }
    ``` _
    

Os TAB dentro do bloco de código sempre são mantido. Linhas destacadas com [code h=3] não são suportadas.

  • Parágrafos normais: não podem ter mais de um nível de TAB.

Não há suporte a:

  • [index]
  • [ref-label]
  • [label] nem [img label-logo]

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.