guoyu07 / flylatex

FlyLatex: A Realtime Collaborative Environment (with a concurrent editor) in node-js.

FlyLatex

This project is no longer being maintained

FlyLatex is a real-time collaborative environment for LaTeX built in nodejs. It includes a beautiful LaTeX ACE Editor and a PDF renderer.

FlyLatex gives you:

• A Real Time Collaborative Code Editor

• Real Time updates on status and privileges of Latex Documents

• Easy way to Compile LaTeX to PDF Online

• Easy LateX Debugging Online

• Easy Manipulation of Compiled PDFs

• Easy Sharing of PDFs

• An Open Source product that's easy to Customize

• Option to use images, additional packages (like .sty files) by specifying configs.includes.path

Screen Shots of the Internals of the FlyLatex application

Check it out here

Setup

To use FlyLatex, you must have node, npm, mongodb installed. So if you haven't already installed all these, do so before moving on.

Also, if you want to store and render pdf's and not just edit your LaTeX files, you must have the program pdflatex command line tool installed. If not, install it. FlyLatex stores compiled pdfs in the directory config.directory.path specified in configs.js.

To install FlyLatex, first clone the repository: git clone https://github.com/alabid/flylatex.git

cd into the directory flylatex. Open the file configs.js with your favorite editor and edit the file to reflect your storage setup and your database setup. Use configs.pdfs.path to specify where you want to store your output pdfs in. Use configs.includes.path to specify what directory your TeX includes/packages/images are stored, for use during compilation of any LaTeX document.

var config = {
    port: 3001
    , pdfs: {
        // absolute path of where to store compiled pdfs
        // defaults to "pdfs" directory in "flylatex" repo
        path: ""
    }
    , db : {
        // for example: mongodb://localhost/flydb3"
        url : "mongodb://localhost/flydb"
    }, docs: {
        // maximum number of documents per user
        MAX_NUM_PER_USER : 20
    }, includes: {
        // specify directory (absolute path) containing latex includes
        // defaults to "texpackages" directory in "flylatex" repo
        path: ""
    }  
};

Then run the command npm install -d to install all the dependencies for the FlyLatex nodejs app. This should take only a few minutes.

For more information on how to setup FlyLatex on Ubuntu, see this

Usage

You'd have to first start the mongo daemon using the command

  mongod --dbpath <some mongodb path>

<some mongodb path> could be ~/mongodb or any other place you have a mongodb path.

Then cd into the directory (if you aren't already there) and run the command foreman start. This should invoke the Procfile in that directory (if you have the foreman gem installed) and start the server via:

web: node app.js

You should see a command-line message telling you the port number on which the app lives. For example, I saw the message

20:38:10 web.1     | Express server listening on port 5000 in development mode

So I had to visit http://localhost:5000. Yours might be different. Watch out.

If you don't have the foreman gem installed, start the app via node app.js.

Feedback, Bugs, Suggestions

I'd really like your feedback, comments, and bug reports sent to me somehow preferably by filing an issue (github feature).

Author

Daniel Alabi

Version

1.0

MIT Open Source License

Copyright © 2012 Daniel Alabi

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.