Version: 0.160105.3
Credits: Original concept by Jonathan Godfrey, coding by James Curtis.
Feedback: Bugs and enhancement suggestions should be sent to Jonathan Godfrey a.j.godfrey@massey.ac.nz
## What is WriteR?This editor was created because blind R users cannot use the excellent RStudio integrated development environment (IDE) with their screen reader software. The first task that the WriteR application makes possible for blind users is the processing of markdown with embedded R code. This could prove invaluable for blind students completing assignment work.
In addition to the files in the current download, you need to have three other applications installed on your computer to make the editor fully functional:
The following is a set of instructions that is Windows-centric. If you are a Linux or Mac user and you know what you are doing given what you read for the Windows users, please do share your experiences with the developers. We’d love to pass your knowledge on to others and we will give you credit for your efforts.
If you downloaded WriteR as a zip file then it has one program file and several test files, including the file you are now reading. Put the downloaded file into a folder where you want to do your working. Unzip it here.
When you first open WriteR, by hittin Enter on the WriteR.pyw file, the application will create an options file called “WriteROptions” in the working directory alongside WriteR.pyw. You will need to open this file using your favourite text editor to review its contents. We are primarily concerned that WriteR has maanged to find your R installation when it created the WriteROptions file.
The first thing you will need to do when WriteR opens is to choose a file to edit. If you do not want to edit an existing file, hit the “Escape” key or the “Cancel” button. If you have used the application before, the last file you edited will be opened automatically.
A second option for opening WriteR does exist if you are comfortable using hte command line in Windows. If you navigate to the working directory where you can see the WriteR.pyw file, then you should be able to open the application by typing WriteR.pyw at the prompt. If you like this way of working, then you can look forward to expanding the use of the command line approach to add the name of the file you wish to edit as the argument to the command.
If you did not understand the second option just presented, stick to using the first option given above.
Linux users: do what?
Mac users: do what?
Go to the section which continues with help on basic editing of your first document.
WriteR is bundled in the BrailleR ppackage for R. Convenience functions have been written to get you started as easily as we can manage.
Start editing your file once you can see WriteR has opened up a window properly. If you did not choose a file, some default text was put in the window for you.
When you have typed enough and want to see how it is represented in HTML, you will “build” the HTML document. A menu item does exist for this but the hot key is set to f5. You must save your work immediately prior to the build process using the ctrl+s hot key.
The newly updated HTML file is in the same folder as the Rmd file you are editing. If all has gone to plan, that will be the Working folder. You will need to browse to that folder manually to find the new file and open it in the browser of your choice. You can keep this file open. After you update the Rmd file in the editor and re-build the HTML, you will need to refresh the HTML file being viewed by hitting f5 in the browser. We’ll try to make this a smoother exercise in future releases.
So, the steps to update your html file after some editing of your Rmd file is: save, build, switch, refresh. In terms of hot keys, that is ctrl+s, f5, alt+tab, and f5. N.B. you might need to alt+tab a few times to work through the windows that are open at present.
To find out how to create R markdown content, take a look at the file “Basics.Rmd” bundled with the application. Once you open it in WriteR, try to build it to see how the R content appears. There is plenty of documentation out there for writing R markdown documents so we don’t need to include it here.
The installation process is about as clean as it can be. To remove WriteR you only need to delete the folder where you put the files for the application. There is no uninstallation process to work through.