Asciidoc FX é um editor WYSIWYG para linguagem de marcação Asciidoc. Você pode criar livros, documentos e slides em PDF, Epub e HTML. AsciidocFX também é vencedor do Duke's Choice Award 2015.
Pré-visualização em tempo real
Multiplataforma (Windows, Mac, Linux)
Criando livros Asciidoc
Criação de PDF, HTML, Epub, Mobi, Docbook
Visualizador de epub
Suporte a navegador externo
Gerador de Tabela
Extensão MathJax
Extensão PlantUML
Extensão Sereia (Experimental)
Extensão ditaa
Extensão da árvore do sistema de arquivos
Extensão de gráficos JavaFX
Marcador de código-fonte
Conversor Revelar.js
Conversor Deck.js
Suporte Nashorn
Emulador de pseudo terminal
Tema (escuro e branco) _Novo _
Existem vários sistemas operacionais suportados pelo AsciidocFX.
Observação | Os lançamentos mais recentes estão disponíveis na página de lançamentos do Github. |
Sistemas operacionais e compilações compatíveis mostram a lista de compilações disponíveis com links para referência. Se você está procurando a versão mais recente, visite o link na nota acima para ter a garantia de baixar a melhor e mais recente versão do AsciidocFX.
Observação | Obrigado por nos fornecer licença de código aberto para os instaladores usados na distribuição do AsciidocFX. |
Observação | Em todas as versões, usamos JREs AdoptOpenJDK, portanto, você não terá nenhum problema de licenciamento em relação ao JRE incluído. |
SO | Nome do arquivo |
---|---|
Mac | AsciidocFX_Mac.dmg |
Mac M1 | AsciidocFX_Mac_M1.dmg |
Windows | AsciidocFX_Windows.exe |
Windows | AsciidocFX_Windows.zip |
Linux | AsciidocFX_Linux.tar.gz |
Linux DEB | AsciidocFX_Linux.deb |
RPM do Linux | AsciidocFX_Linux.rpm |
Você pode instalar o AsciidocFX por meio dos instaladores Deb ou Rpm ou por meio do arquivo Archive.
$ tar –xvzf AsciidocFX_Linux.tar.gz
$ cd AsciidocFX/bin
$ chmod +X ./AsciidocFX
$ ./AsciidocFX
Baixe o executável/instalador e execute-o.
Baixe o .dmg
e execute-o.
ou
Use o Homebrew para instalá-lo com um comando: brew install --cask asciidocfx
Vídeo - Escrevendo livros com Asciidoc FX
AsciidocFX pode converter documentos Asciidoc em HTML, PDF, EPUB3 e DOCBOOK5.
AsciidocFX converte documentos por meio da biblioteca AsciidoctorJ. Para back-ends de PDF, alternativamente, a conversão Docbook → Fop → PDF pode ser utilizada.
AsciidocFX suporta muitas extensões como PlantUML, Ditaa, Charts, File Trees e muitas outras Asciidoctor Diagram que podem ser encontradas em https://docs.asciidoctor.org/diagram-extension/latest/
Você pode atender às suas necessidades de UML com AsciidocFX. Suporta PlantUML. AsciidocFX converte esses elementos textuais UML como imagem png ou svg.
PlantUML é um componente que permite escrever rapidamente:
Diagrama de sequência,
Diagrama de caso de uso,
Diagrama de classes,
Diagrama de atividades, (aqui está a nova sintaxe),
Diagrama de componentes,
Diagrama de estado,
Diagrama de objetos.
interface gráfica wireframe
. UML Diagram Example
[ uml , target = "uml-example" ]
--
abstract class AbstractList
abstract AbstractCollection
interface List
interface Collection
List <|-- AbstractList
Collection <|-- AbstractCollection
Collection <|- List
AbstractCollection <|- AbstractList
AbstractList <|-- ArrayList
class ArrayList {
Object [] elementData
size ()
}
enum TimeUnit {
DAYS
HOURS
MINUTES
}
annotation SuppressWarnings
--
Observação | Em alguns elementos UML, PlantUML precisa funcionar com Graphviz. Por isso, você deve instalar Graphviz manualmente para sua plataforma. Depois de instalar o Graphviz, você deve definir a variável de ambiente GRAPHVIZ_DOT como dot executável no Graphviz. |
Mermaid permite criar diagramas usando texto e código. Isso simplifica a manutenção de diagramas complexos. Veja mais exemplos : https://mermaid-js.github.io/
Observação | sereia-cli deve ser instalado para geração de diagramas de sereia. npm install @mermaid-js/mermaid-cli Detalhes de instalação: https://github.com/mermaid-js/mermaid-cli#install-locally |
[mermaid,target="mermaid-graph"]
--
graph TD
A[Start] -- > B{Is it?};
B -- Yes -- > C[OK];
C -- > D[Rethink];
D -- > B;
B -- No -- -- > E[End];
--
[mermaid,target="mermaid-flowchart"]
--
flowchart TB
c1 -- >a2
subgraph one
a1 -- >a2
end
subgraph two
b1 -- >b2
end
subgraph three
c1 -- >c2
end
one -- > two
three -- > two
two -- > c2
--
AsciidocFX suporta diagramas ditaa.
ditaa é um componente que converte diagramas desenhados em arte ascii em gráficos bitmap.
.ditaa Diagram Example
[ditaa,target="ditaa-example"]
--
+--------+ +-------+ +-------+
| |- -- + ditaa + - -- >| |
| Text | +-------+ |diagram|
|Document| |!magic!| | |
| {d} | | | | |
+---+----+ +-------+ +-------+
: ^
| Lots of work |
+-------------------------+
--
MathJax é um mecanismo de exibição JavaScript de código aberto para matemática que funciona em todos os navegadores.
Você pode usar as linguagens Tex
ou MathML
para descrever fórmulas matemáticas no AsciidocFX. AsciidocFX converte essas fórmulas textuais como imagem PNG ou SVG.
[latexmath,target="tex-formula"]
--
begin { align }
dot {x} & = sigma (y-x) \
dot {y} & = rho x - y - xz \
dot {z} & = - beta z + xyp
end { align }
--
[mathml,target="mathml-formula"]
--
< math xmlns = " http://www.w3.org/1998/Math/MathML " display = " block " >
< mi >x</ mi >
< mo >=</ mo >
< mrow >
< mfrac >
< mrow >
< mo > − </ mo >
< mi >b</ mi >
< mo > ± </ mo >
< msqrt >
< msup >
< mi >b</ mi >
< mn >2</ mn >
</ msup >
< mo > − </ mo >
< mn >4</ mn >
< mi >a</ mi >
< mi >c</ mi >
</ msqrt >
</ mrow >
< mrow >
< mn >2</ mn >
< mi >a</ mi >
</ mrow >
</ mfrac >
</ mrow >
< mtext >.</ mtext >
</ math >
--
Você pode representar a árvore do sistema de arquivos no seguinte bloco tree
. Existem dois estilos de árvore FS.
[ tree , target = "tree-view" ]
--
# src
## main
### java
#### com
##### kodcu
###### App . java
### resources
#### css
##### style . css
#### js
##### script . js
#### images
##### image . png
--
Quando você arrasta e solta uma pasta no editor, o AFX irá gerar essa árvore semelhante automaticamente.
[ tree , target = "tree-view-new" ]
--
root
|-- photos
| |-- camp . gif
| |-- festival . png
| `-- balloon . jpg
|-- videos
| |-- car - video . avi
| |-- dance . mp4
| |-- dance01 . mpg
| |-- another video . divx
| `-- school videos
| `-- firstday . flv
|-- documents
| |-- jsfile . js
| |-- powerpoint . ppt
| |-- chapter - 01. asc
| |-- archive - db . zip
| |-- . gitignore
| |-- README
| `-- configuration . conf
`-- etc .
--
JavaFX possui 8 tipos de componentes gráficos e AsciidocFX suporta todos eles.
[chart,pie,target="secim-2014-pie",opt="title=2014 YEREL SEÇİM SONUÇLARI"] -- AKP, 45,6, laranja CHP, 27,8,vermelho HPM, 15,2 PIB, 4,2 SP, 2 --
[gráfico, área, alvo = "gráfico de área"] -- //Abril 1, 4 3, 10 6, 15 9, 8 12, 5 //Poderia 1, 20 3, 15 6, 13 9, 12 12, 14 --
Para outros gráficos e opções disponíveis, consulte a página wiki da extensão de gráfico!
Em primeiro lugar, instale o JDK 17
Baixe o Apache Maven e defina o diretório /bin
para variáveis de ambiente
Entre no diretório AsciidocFX
e execute $ mvn clean install
Siga para o diretório target/appassembler/bin
e você verá asciidocfx.sh
e asciidocfx.bat
Observação | Estamos gerando builds com Github Actions automaticamente. |
GitHub
ePub + Kindle + PDF
GitHub
ePub + Kindle + PDF
Versão mais antiga no GitHub e GitBook
ePub + Kindle + PDF
AsciidocFX oferece suporte a slides usando o back-end Asciidoctor Reveal.js. Para começar a criar slides, basta seguir o menu Novo › Slide .
Depois disso, o AFX solicitará um nome de diretório de espaço livre e "OK" você verá a demonstração do slide.
Você pode alternar facilmente entre revelado.js e deck.js alterando o comentário abaixo. Além disso, você pode definir as configurações padrão editando _settings_reveal.adoc
e include::_settings_deck.adoc
.
include::_settings_reveal.adoc[]
AsciidocFX usa tecnologias relacionadas a Java, JavaScript e XML.
Java FX 18
AsciidoctorJ
Asciidoctor.js (obsoleto)
Bota Primavera
Primavera WebSocket
Documento
Apache Fop
Saxão 6,5
Editor ás
Você pode configurar o AsciidocFX com a página Configurações (pressione Ctrl + F4 ). Todas as configurações localizadas na pasta [Install_Dir]/conf.
O editor no AsciidocFX é baseado em Ace.js (https://github.com/ajaxorg/ace/wiki/Default-Keyboard-Shortcuts). AsciidocFX oferece suporte aos atalhos de teclado listados abaixo. Todos são configuráveis em Settings > Shortcut
. Os eventos do teclado são gerenciados pelo AsciidocFX. Se por algum motivo você quiser que eles sejam manipulados pelo próprio Ace.js, você pode desativar o "Manipulador de atalho personalizado" nas configurações.
Descrição | Atalho (Win/Linux) | Atalho (Mac) | Nome do Comando |
---|---|---|---|
Adicionar cursor acima | Ctrl + Alt + Cima | Ctrl + Alt + Cima | addCursorAbove |
Adicionar cursor acima (pular atual) | Ctrl + Alt + Shift + Cima | Ctrl + Alt + Shift + Cima | addCursorAboveSkipCurrent |
Adicione o cursor abaixo | Ctrl + Alt + Baixo | Ctrl + Alt + Baixo | addCursorBelow |
Adicionar cursor abaixo (pular atual) | Ctrl + Alt + Shift + Baixo | Ctrl + Alt + Shift + Baixo | addCursorBelowSkipCurrent |
Adicione uma nova linha após a linha atual | Comando + Retorno | Comando + Retorno | adicionarLinhaDepois |
Adicione uma nova linha antes da linha atual | Comando + Shift + Retorno | Comando + Shift + Retorno | addLineBefore |
Alinhar cursores | Ctrl + Alt + A | Ctrl + Alt + A | alinharCursores |
Anexar título | Ctrl + H | Ctrl + H | cabeçalho adicional |
Retrocesso | Shift + Backspace OU Backspace | Ctrl + Backspace OU Shift + Backspace OU Backspace OU Ctrl + H | retroceder |
Recuo de bloco | Ctrl+ | Ctrl+ | recuo de bloco |
Bloquear recuo | Ctrl + [ | Ctrl + [ | bloquear dente |
Seleção ousada | Ctrl + B | Comando + B | selecionado em negrito |
Seleção central | Ctrl + L | seleção central | |
Alterar modo de idioma… | Comando + K OU Entrada + M | Comando + K OU Entrada + M | modoSelecionar |
Codificar seleção | Ctrl + Shift + C | Comando + Shift + C | selecionado por codificação |
Copia a seleção no editor | Ctrl + C | Comando + C | copiarX |
Copiar linhas para baixo | Ctrl + D | Comando + D | copylinesdown |
Copiar linhas | Alt + Shift + Cima | Comando + Opção + Acima | copylinesup |
Corta a seleção no editor | Ctrl + X | Comando + X | cortarX |
Excluir | Excluir OU Ctrl + D OU Shift + Excluir | Excluir OU Ctrl + D OU Shift + Excluir | del |
Seleção duplicada | Ctrl + Shift + D | Comando + Shift + D | seleção duplicada |
Expandir para linha | Ctrl + Shift + L | Comando + Shift + L | expandtolina |
Expandir para correspondência | Ctrl + Shift + M | Ctrl + Shift + M | expandToMatching |
Encontrar | Ctrl + F | Comando + F | encontrar |
Encontre tudo | Ctrl + Alt + K | Ctrl + Alt + G | encontrar tudo |
Encontre o próximo | Ctrl + K | Comando + G | encontrar próximo |
Encontrar anterior | Ctrl + Shift + K | Comando + Shift + G | encontrar anterior |
Dobrar | Alt-L OU Ctrl-F1 | Comando-Alt-L OU Comando-F1 | dobrar |
Dobre tudo | Comando + K OU Comando + 0 | Ctrl + Comando + Opção + 0 | dobrável |
Dobre todos os comentários | Ctrl + Comando + Opção + 0 | dobrarTodosComments | |
Dobre outro | Alt + 0 | Comando + Opção + 0 | dobrarOutro |
Desça a linha | Baixo OU Ctrl + N | Baixo OU Ctrl + N | golinedown |
Vá se alinhar | Acima OU Ctrl + P | Acima OU Ctrl + P | golineup |
Ir para o fim | Ctrl + Fim | Comando + Fim OU Comando + Baixo | ir até o fim |
Vá para a esquerda | Esquerda OU Ctrl + B | Esquerda OU Ctrl + B | ir para a esquerda |
Ir para o fim da linha | Alt + Direita OU Fim | Command + Direita OU Fim OU Ctrl + E | gotolineend |
Ir para o início da linha | Alt + Esquerda OU Início | Command + Esquerda OU Home OU Ctrl + A | gotolinestart |
Vá para a fila… | Ctrl + L | Comando + L | gotolina |
Ir para o próximo erro | Alt + E | F4 | goToNextError |
Ir para a página abaixo | Página para baixo OU Ctrl + V | Página para baixo OU Ctrl + V | gotopagedown |
Ir para o erro anterior | Alt + Shift + E | Shift + F4 | goToPreviousError |
Vá para a direita | Direita OU Ctrl + F | Direita OU Ctrl + F | ir para a direita |
Vá para começar | Ctrl + Início | Command + Home OU Command + Up | começar |
Vá para a palavra esquerda | Ctrl + Esquerda | Opção + Esquerda | gotowordleft |
Vá para a palavra certa | Ctrl + Direita | Opção + Direita | vá para a palavra certa |
Seleção em itálico | Ctrl + I OU Ctrl + İ OU Ctrl + I OU Ctrl + I | Comando + I OU Comando + © OU Comando + I OU Comando + I | selecionado em itálico |
Ir para a correspondência | Ctrl + ] OU kbd:[Ctrl + P | kbd:[Command+] | pular para combinar |
Modificar número para baixo | Ctrl + Shift + Baixo | Alt + Shift + Baixo | modificarNumberDown |
Modificar número para cima | Ctrl + Shift + Cima | Alt + Shift + Cima | modificarNumberUp |
Mover linhas para baixo | Alt + Baixo | Opção + Baixo | movelinesdown |
Mover linhas para cima | Alt + Cima | Opção + Acima | movelinesup |
Abrir link | Ctrl + F3 | F3 | link aberto |
Abrir paleta de comandos | F1 | F1 | openCommandPallete |
Outdent | Shift + Tabulação | Shift + Tabulação | recuar |
Página para baixo | Ctrl + página para baixo | Opção + página para baixo | página para baixo |
Página acima | Ctrl + Página para cima | Opção + página para cima | paginação |
Cola da área de transferência para o editor AsciidocFX | Ctrl + Shift + V | Comando + Shift + V | colarX |
Refazer | Ctrl + Shift + Z OU Ctrl + Y | Comando + Shift + Z OU Comando + Y | refazer |
Remover linha | Ctrl + D | Comando + D | remover linha |
Remover até o final da linha | Alt + Excluir | Ctrl + K OU Comando + Excluir | removertolineend |
Remover para o início da linha | Alt + Backspace | Comando + Backspace | removertolinestart |
Remover palavra à esquerda | Ctrl + Backspace | Alt + Backspace OU Ctrl + Alt + Backspace | removerpalavraesquerda |
Remova a palavra certa | Ctrl + Excluir | Alt + Excluir | removerpalavradireita |
Substituir | Ctrl + H | Comando + Opção + F | substituir |
Reproduzir macro | Ctrl + Shift + E | Comando + Shift + E | macro de repetição |
Selecionar tudo | Ctrl + A | Comando + A | selecionar tudo |
Selecione para baixo | Shift + Baixo OU Ctrl + Shift + N | Shift + Baixo OU Ctrl + Shift + N | seleção para baixo |
Selecione à esquerda | Shift + Esquerda OU Ctrl + Shift + B | Shift + Esquerda OU Ctrl + Shift + B | selecione à esquerda |
Selecione mais depois | Ctrl + Alt + Direita | Ctrl + Alt + Direita | selecioneMaisDepois |
Selecione mais antes | Ctrl + Alt + Esquerda | Ctrl + Alt + Esquerda | selecioneMaisAntes |
Selecione próximo depois | Ctrl + Alt + Shift + Direita | Ctrl + Alt + Shift + Direita | selecionePróximoDepois |
Selecione próximo antes | Ctrl + Alt + Shift + Esquerda | Ctrl + Alt + Shift + Esquerda | selecionePróximoAntes |
Selecione ou encontre o próximo | Alt + K | Ctrl + G | selecioneOrFindNext |
Selecione ou encontre o anterior | Alt + Shift + K | Ctrl + Shift + G | selectOrFindAnterior |
Selecione certo | Shift + Direita | Shift + Direita | selecione à direita |
Selecione para finalizar | Ctrl + Shift + Fim | Command + Shift + End OU Command + Shift + Baixo | selecione para finalizar |
Selecione para o final da linha | Alt + Shift + Direita | Command + Shift + Direita OU Shift + Fim OU Ctrl + Shift + E | selecttolineend |
Selecione para iniciar a linha | Alt + Shift + Esquerda | Command + Shift + Esquerda OU Ctrl + Shift + A | selecione paralinestart |
Selecione para combinar | Ctrl + Shift + ] OU kbd:[Ctrl + Shift + P | kbd:[Command+Shift+] | selecione para combinar |
Selecione para começar | Ctrl + Shift + Início | Command + Shift + Home OU Command + Shift + Cima | selecione para iniciar |
Selecione | Shift + Cima OU Ctrl + Shift + P | Shift + Cima OU Ctrl + Shift + P | seleção |
Selecione a palavra à esquerda | Ctrl + Shift + Esquerda | Opção + Shift + Esquerda | selecione palavra à esquerda |
Selecione a palavra certa | Ctrl + Shift + Direita | Opção + Shift + Direita | selecione palavra à direita |
Mostrar console do Firebug | F12 | F12 | firebug-lite |
Mostrar números de linha | Ctrl + L | Comando + L | números de linha |
Mostrar menu de configurações | Ctrl + , | Comando + , | mostrarMenuConfigurações |
Classificar linhas | Ctrl + Alt + S | Comando + Alt + S | linhas de classificação |
Dividir em linhas | Alt + Shift + I | Alt + Shift + I | dividirSelectionIntoLines |
Linha dividida | Ctrl + O | linha dividida | |
Dividir a seleção em linhas | Ctrl + Alt + L | Ctrl + Alt + L | alternarSplitSelectionIntoLines |
Trechos de guia e texto | Guia | Guia | recuar |
Para minúsculas | Ctrl + Shift + U | Ctrl + Shift + U | em minúsculas |
Para maiúsculas | Ctrl + você | Ctrl + você | maiúsculas |
Alternar bloco de comentário | Ctrl + Shift + / | Comando + Shift + / | toggleBlockComment |
Alternar comentário | Ctrl + / | Comando + / | alternar comentário |
Alternar widget de dobra | F2 | F2 | alternarFoldWidget |
Alternar widget de dobra pai | Alt + F2 | Alt + F2 | alternarParentFoldWidget |
Alternar gravação | Ctrl + Alt + E | Comando + Opção + E | alternar gravação |
Transpor letras | Alt + Shift + X | Ctrl + T | transpor letras |
Seleção de sublinhado | Ctrl + você | Comando + você | sublinhado selecionado |
Desfazer | Ctrl + Z | Comando + Z | desfazer |
Desdobrar | Alt-Shift-L OU Ctrl-Shift-F1 | Command-Alt-Shift-L OU Command-Shift-F1 | desdobrar |
Desdobre tudo | Alt + Shift + 0 | Comando + Opção + Shift + 0 | desdobrar tudo |
Nas plataformas Linux você pode enfrentar esse problema. Para solucionar o problema, você precisa instalar o Microsoft Core Fonts em sua plataforma. Como instalar [microsoft-core-fonts]
Há um bug no JavaFX que faz com que todos os teclados de um Mac se comportem como "QWERTY". Isto significa que em um layout "QWERTZ" alemão os atalhos para undo
e redo
são trocados.
Se você estiver se distraindo com artefatos de texto arco-íris no texto, poderá contornar o problema passando algumas opções de VM em [Install_Dir]/AsciidocFX.vmoptions
, conforme compartilhado neste bug do RichTextFX.
Abra AsciidocFX.vmoptions
.
Adicione -Dprism.text=t2k
e -Dprism.lcdtext=false
ao arquivo.
Salve e feche.
Inicie o AsciidocFX
Para ver o que mudou nas versões recentes do AsciidocFX, consulte o CHANGELOG
Apoie AsciidocFX com solicitações pull ou abra um problema para solicitações de bugs e recursos. Você pode discutir no grupo de e-mail ou na sala de chat do Gitter.im.
Obrigado a todas as pessoas que já contribuíram para o AsciidocFX!
Obrigado a todos os nossos apoiadores! [Torne-se um apoiador]
Obrigado a todos os nossos patrocinadores! (peça à sua empresa para também apoiar este projeto de código aberto, tornando-se um patrocinador)