Hi, I'm a big fan of the **reStructuredText** (rST) markup language: It's a quite simple but still powerful notation to write complex content. It's used a lot in the documentation of software libraries, but frankly I think it has the potential to replace Word and/or LaTex for academic publications.
Once you've written your rST manuscript (a simple editor is enough for that), you can turn it into PDF (via Sphinx & LaTex), HTML, EPUB etc. There are even online service like https://notex.ch that make it very easy for you to learn this language.
Now, what I don't understand: When I mention rST to my PhD friends or people who in general write complex content, the usual reaction is either complete fascination or simply (continued) ignorance!
I think Word is really simply a bad choice if people want to show their thesis in a presentable manner, since although it is *possible* to write nice looking content, it's very easy to screw things up. On the other hand I really understand people who can't stand LaTex either due to it's cryptic language to express content **and** presentation (layout configuration, styles etc.) within the same document.
When I stumbled upon rST - which has been created about 10 years ago - I was immediately converted and never looked back on Word or even LaTex. But, when I preach it's benefits to PhD/MSc candidates then they usually say nice, but keep using Word/LaTex. .. I don't get it.
So my question would be: Why? Is maybe something with rST wrong? In terms of complexity it is somewhere between Word and LaTex. Or is it that Word users simply refuse anything that looks remotely tech and LaTex users have been using it since eternity, and they will keep using it for another eternity?
What I try to figure out is the psychology of potential users and the way users are attached to a particular piece of software; any insight here is very much appreciated. Thank you! :)
My first impression is that it looks good for someone who doesn't already use LaTeX (like myself) as the learning curve may be less steep. It's also quite neat that you can export as HTML and LaTeX, not only PDF :)
The biggest problem that I can see is that the documentation is sparse and very 'techie'.
Installation of Word is a no-brainer (MS Office Suite has to be easy to install and use, given its target market is like everyone under the sun), and although LaTeX is a little more complex, there is an abundance of online support. And from my not-so-deep peruse of how to get the environment for rST up and running on my machine, I'm finding the documentation very unwieldy.
The fact that you have to have python up and running would probably be confusing too. I can't really imagine anyone who isn't of a technical background and who doesn't already know how to script (in which case, would probably already be using LaTeX) be persuaded to use it otherwise.
I used Word for my thesis.
Why? cos it was already on my computer......... because it was easy to send things to my supervisors who also used it.......... because it was all I'd known for the last how ever many years and I didn't (and still don't) know what the alternatives do that Word can't....... and finally because I had no problems with Word, so there was nothing to give me the push to use other things.
hi hsk81
thanks for posting! I have not heard of **reStructuredText** (rST) so thank you for introducing this to me.
I only started using Latex because Word was running very slowly on my mac--and there was some incompatibility when I worked on my Word.doc on the pc--and then on the mac, and problems with referencing also occurred across platforms.
I wrote my thesis using LaTeX and for journal drafts I use Word because my supervisor likes word and doesn't really want to learn anything new.
For people to use rST (or Latex, whatever..and etc.) they need to have trouble-shooting tips and solutions, I think this is the biggest obstacle to using it. People generally want to do things painlessly.
I know about pain (HAHAHAHA) because I went through 2+ difficult weeks learning latex by myself. When I went online to see the issues and solutions on the latex forum, at first I couldn't even understand what users were talking about!!!
will you be using rST all the way then?
love satchi
@contradirony
@catalinbond
@satchi
Stay away from Sphinx. It's terrible.
It has
* extremely limited markup (no bold and at the same time italic text, no text-colour, no fine control over tables)
* Bad pdf output (tables with column / row spanning is broken; image placement is restricted)
If you want to do good writing, use LaTex or Asciidoc (via asciidoctor)!
Asciidoc is really great, if you want a easily human-readable source. (It has none of the problems mentioned above).
PostgraduateForum Is a trading name of FindAUniversity Ltd
FindAUniversity Ltd, 77 Sidney St, Sheffield, S1 4RG, UK. Tel +44 (0) 114 268 4940 Fax: +44 (0) 114 268 5766
An active and supportive community.
Support and advice from your peers.
Your postgraduate questions answered.
Use your experience to help others.
Enter your email address below to get started with your forum account
Enter your username below to login to your account
An email has been sent to your email account along with instructions on how to reset your password. If you do not recieve your email, or have any futher problems accessing your account, then please contact our customer support.
or continue as guest
To ensure all features on our website work properly, your computer, tablet or mobile needs to accept cookies. Our cookies don’t store your personal information, but provide us with anonymous information about use of the website and help us recognise you so we can offer you services more relevant to you. For more information please read our privacy policy
Agree Agree