Here i found out about restructuredtext and markdown as a markup language for documentation. After some reading i concluded that restructuredtext is more in tune with what i am trying to accomplish e.g: it can be converted into latex if i want to incorporate bibliography from latex
What are your experiences on using markup language for writing general or academic documents(using figures, tables, bibliography, etc)? do you have suggestions regarding this topic?
PS: I mainly using linux
amd Here are some applications for writing markup language that i found:
https://notex.ch/ (rst, markup, latex) -- it seems to be made with GWT
http://rst.ninjs.org/ (rst)
https://github.com/github/markup (many)
http://sourceforge.net/projects/retext/
edit:
i agree with the expression "when you have a hammer, you see every problem as a nail" as stated by commenters.
but right now i am not proficient enough with a tool to switch or compare with another one.
some commenter suggest that i really invest in learning latex. i was starting to learn latex from wikipedia wikibook when i got intimidated by it and went to searching for alternatives.
based on the commenters some ways/applications to ease this learning are:
1. lyx
2. www.writelatex.com
3. using latex templates
4. scrivener
any other suggestions?
Overall, I would recommend using LaTeX because its really not too difficult to pick up.
[1] https://www.writelatex.com/blog/7-free-online-introduction-t...
There's only one thing about writeLaTex that convinced me to stop using the service (which I used while learning LaTeX) and to start doing all editing locally. This is the behavior when the connection is lost/dropped momentarily. The red bar appears at the top of the screen, but I'm still able to type, only to have my typing disappear a few seconds later and the cursor reset to the top of the input box. This is incredibly annoying even when it only happens once every 15 minutes. It seems like this could be fixed very easily (just store what I'm typing locally and then sync it to your servers).
Also, this isn't so much a complaint but a feature request: I'd be much less paranoid about writeLaTeX going down when I need to print/access a major report or something if there was a way to automatically save files locally. This could be done using the Dropbox or Google Drive APIs. For an example of these feature, you can try editing a file in Dropbox with https://draftin.com/ .
Thanks a ton, besides these warts I love the product!
but is there a free (limited) plan for someone like me who still trying to learn latex.
You can, of course, write natively in LaTex but the program wasn't designed for that.
So I would say that it might be worth reconsidering LaTeX because it has http://www.bibtex.org/ which is excellent for academic papers. The investment to get competent with LaTeX is certainly several hours, but it pays itself back quickly. See http://en.wikibooks.org/wiki/LaTeX for a good learning resource.
For myself, I mainly use http://orgmode.org/ for emacs. This can export as LaTeX, and from there to any of the vast multitude of formats that LaTeX can be converted to. However, if you're not willing to learn LaTeX, then you're probably not willing to learn emacs either: where LaTeX is a matter of hours to learn competently, emacs takes weeks.
I used Markdown to write the bulk of my text for a while, but I found it didn't scale very well to large documents. It is great for blog posts and the like.
>>I used Markdown to write the bulk of my text for a while, but I found it didn't scale very well to large documents. It is great for blog posts and the like.
what do you use for large documents? does it have references /bibliography supports?
You can also export directly from Scrivener to LaTex, but a thesis is going to require a good deal of back and forth and revisions before it is ready for typesetting.
If you don't want to have a typeset final product, you can write in Scrivener and export to many different formats. If you want to write using Markdown syntax, you can do so in Scrivener as well. It's a terrific program.
http://literatureandlatte.com/forum/viewtopic.php?f=33&t=252...
LaTeX can get hard, but templates lower the learning curve. Google "latex report templates," learn how to compile them, play with them. Even if it's harder the first day, it will be a lot more useful in the long term.
The learning curve is not a fair excuse not to try it. If you try it, build things with it, and don't like it, you'll know what you're not missing.
As pointed out elsewhere in this thread, don't make your hammer solve all of the problems.
As to my particular setup, I write Pandoc markdown in Vim using a plugin which I wrote for that purpose.[2] Nothing fancy, mind you, just light syntax highlighting, some keyboard shortcuts for (1) exporting to html or pdf (via-LaTeX) and (2) jumping between headers, and document folding, the latter of which is especially useful for outlining and organizing lengthy documents.
I've used it for two papers for arXiv, with equations and tables. It can write any math formula you can write on paper. You don't need to learn Latex at all to use it. It's very clear and intuitive. It's not WYSIWIG, but it's clear what you're going to get, and what you need to do on-screen to get what you want.
And,if you're on Linux, you should be able to get it running with no sweat.
However, LaTeX has features designed for academic writing (e.g. you can have references to sections / bibliography entries, so when you insert or delete new ones, the numbers in the text are updated automatically.)
You don't mention what subject your thesis is in, but if it involves mathematical notation, you will likely have a lot more work and poorer results if you use anything but LaTeX.
Specifically related to the question of using LaTeX's mathematical typesetting capabilities in documentation or webpages, MathJax [1] is a popular solution. The Python-based static blog generator Nikola [2] has support for MathJax.
As for being intimidated by LaTeX, and being too unfamiliar with alternatives to make a comparison, I suggest spending a day or so trying to write a small part of your report in LaTeX, then deciding after you've used it.
here are some factors that drive my decision:
- i can start writing content right away without much initial learning
- rst can be read/revised by my other peers with more ease than full blown latex document.
- i can use latex parts (equations, typesetting, etc) inline with rst, and i can learn latex bit-by-bit on the way
- there some libraries/program that can make attractive presentations using rst (http://regebro.github.io/hovercraft/#/step-1)
so i will use rst and learn latex on the way.
Learning LaTeX is absolutely worth the time and effort. I realize it's not the easiest thing to learn, but it's invaluable for keeping track of citations, simple typesetting, and rendering equations. It is not, however, worth using for making slideshows or posters.
Just remember to mark headlines as headings, and don't just change the font size of your headlines. It's easy to insert references to formulas, figures and graphs.
LibreOffice + Zotero makes for the some fairly painless bibliography, table of content, internal figure referencing.
If you need to build advanced graphs from large dataset, there is no painless way about it, but LaTex is in no way more difficult than the other options.
It's like markdown but more mature and scales to large documents.
pandoc is written in haskell and available on linux. for opensuse you can install it from http://software.opensuse.org/search
[i wrote my own thesis in latex, but that was many years ago. another advantage of starting in markdown is that it's easier to get to other formats, like putting your thesis on the web.]