Tutorial:RTextDoc/FAQ

This is a FAQ pages for the activated version of RTextDoc. To view some answers, please login.

LaTeX auto-detection has failed

Check the laTeX installation "Edit→Options→LaTeX". Click "Auto-detect". If it fails, make sure that "MikTex" or "LiveTex" are installed inside the directory "C\Program Files". On Linux/Mac, check install LaTeX and check it with the command "which latex".

Can I use RTextDoc without installed LaTeX?

Yes, you can. One can write a LaTeX document and preview it as a HTML file using "Convert → LaTeX → HTML" converter. It creates a HTML file and previews in a browser (use Mozilla for best performance). Note that only a basic set of LaTeX commands and equations are supported since the conversion is done using a Java 3rd party libraries

Can I use RTextDoc without installed AsciiDoc?

RTextDoc comes with asciidoctor.org installed and you do not need to install other libraries.

Can I preview a PDF file without Acroread viewer?

For best portability and speed, RTextDoc has its own PDF viewer. Use [Macros] → [PDF preview] command.

My update breaks the installed RTextDoc..

In some cases, when we move from one major release to another, update feature may not copy the needed jar files. In this case, please download the newest version and activate this version using your existing username.

Will my membership expire in future?

No, your membership never will expire. You can activate all future releases of RTextDoc with the existing username. However, if we will notice that your username is available in public domain, we may terminate it.

I need to reinstall or reset RTextDoc

If you need to reset RTextDoc to default preferences, simply remove the directory ".rtextdoc". On Windows, it is located in the directory "Documents and Settings" (use search to locate ".rtextdoc"). For Linux/Mac, it is in $HOME/.rtextdoc

Moving RTextDoc to different location

Activated RTextDoc may fail if you will move the installed RTextDoc to a different location. The correct way to relocate RTextDoc is this:

• Remove the preference directory ".rtextdoc" (see above)
• Copy the directory "RTextDoc" with the "rtextdoc.jar" to the final location
• Activate RTextDoc ("Help-> Activate")

Modifying LaTeX commands

You can configure external commands launched from the RTextDoc menu and modify them as needed. This may be needed if LaTeX commands (such as latex, dvips, bibtex) have non-standard locations.

<ifauth ns="rtextdoc"> If one of the commands to compile and view LaTeX file in the [Macros] Menu is not working, try to modify it. For example, if [Macros] ⇒ [Run LaTeX] does not work, check your macro file which executes this command. To do this, go to the directory "macros " and and "common" and open the file which corresponds your operation system.

• For Windows, open "window.groovy" (or)
• For Linux, open "linux.groovy" (or)
• For Mac, open "mac.groovy"

Then search for the line

latexString = "latex -interaction nonstopmode -file-line-error-style |";

and replace "latex" with the proper command.

Re-activating RTextDoc

If, after activation, the commands does not work (like "Run LaTeX".groovy, "Run Acroread.groovy"), you should do a few things:

1) Check that all macro files are in place. Check the unzipped directory:

RTextDoc/macro/

It should be populated by files that have extensions *.groovy and *.py. If not, try to reactivate RTextDoc:

Remove the old preference directory which is usually in:

C:\Users\user\.rtextdoc

(user is your user name)

If you still cannot find it, search for a directory ".rtextdoc" and remove it completely. The restart RTexTdoc (click rtextdoc.bat) and activate it again ("Help"->"Activate"). Then restart the editor. You should see files in RTextDoc/macro/