There are no real good AsciiDoc editors, unless you know the syntax by heart. In the mean time I'll make scripts to handle the conversion of existing documentation "automagically", reducing that headache for myself. It would seem better just to wait patiently until AsciiDoc software improves before pushing it onto others. Asking those same people to work with PanDoc, a command-line tool, to convert MarkDown to AsciiDoc, I think that would be too much. Hence my request for a new place where to look for AsciiDoc editors that look like Word/WordPad. To get a better/quicker adoption of AsciiDoc, it would be a big benefit to have software that enables people with "Office"-mindset to work as they are more or less used to. Actually, it is my opinion that most people would not be able to create documentation without an Office suite anymore. Knowing full well that I am weird this way (and probably many other ways too) I can't expect everyone to work like this. Instead, I use PanDoc to generate the same document in whatever format the receiver wants. As a proponent of wanting to separate content from layout, I don't use Office much anymore. For myself and my work-flow, the current AsciiDoc editors are adequate. While I am put in charge of converting existing documentation to AsciiDoc, those that need/want to make new documentation are not willing to give up their Word GUI habits/mindset to go back 20 years GUI concept-wise. Result? AsciiDoc is now the 11th standard. And continuing with this honesty, it feels like a person or group of persons thought about making a standard better than the 10 earlier attempts of making the standard for documentation. Gaining this knowledge did not improve my career or life in any way. Actually, there is one person at the company receiving the documentation, who made a ruckus about AsciiDoc and now we are all stuck with it.īefore this, I had never heard of AsciiDoc. Heck, even a wiki would have been sufficient. And if you would ask me, Markdown would have been fitting the documentation bill just fine. Which is also why AsciiDoc software is in the state it is. SourceForge, Codeplex, PasteBin and others from this repository list are also a bust.ĭoes anyone here have any more ideas where I could find such software?ĭon't worry, not many people are. GitHub shows a lot of converters and plugins related to AsciiDoc, but not editors (at least not in the first 10 pages of their website's search results). In essence, I am looking for an editor that looks like Word or Wordpad, with similar features as AsciiDocFX. However, for those generations that grew up with Office and Word, any of the above options that will be a hard "sell". Yet it is nicer to use than chopping up the Eclipse IDE (Java again) to turn it into an AsciiDoc editor. As in: click on the preview and the edit section doesn't "follow" to the location where you clicked in the preview and vice versa. There is also Visual Studio Code that has an AsciiDoc extension, but it isn't nice to use, because the preview and the text are not "linked". Or someone like me who is (too?) familiar with wiki markup and editing. So it is workable for someone who is acquainted with that style of working. You could compare it to editing documents "under water" in Word Perfect, except with a vertical split, instead of a horizontal one. Furthermore, it is also Java based (which is not a favorite of mine) and has leaks RAM if you leave the application open too long. All my searches revealed two editors: AsciiDoctor and AsciiDocFXĪsciiDocFX looks reasonable and has some features that are good, but there are also many quirks. Google hasn't helped me much when looking for AsciiDoc editors. The receiver of this documentation is dead set on AsciiDoc and will not hear of anything else.įor Markdown there are quite a few editors that make the creation of Markdown documents a lot easier. In many ways it is similar to Markdown, yet it also isn't. ![]() ![]() AsciiDoc is a text based format and in essence even the the standard notepad in Windows is able to create AsciiDoc documents. For documentation purposes, I have suddenly a need for an AsciiDoc editor.
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |