googlearchive / drivetex Goto Github PK

View Code? Open in Web Editor NEW

35.0 13.0 22.0 253 KB

A cloud LaTeX editor

Home Page: https://drivetex.appspot.com/

License: Apache License 2.0

JavaScript 60.66% CSS 11.34% HTML 28.00%

gsuite latex

drivetex's Introduction

Deprecated

This sample is no longer maintained. No further updates will be made.

DriveTeX

A cloud LaTeX editor. Live at drivetex.appspot.com. Inspired by LaTeX Lab by Bobby Soares.

User Manual

Right now, it's a little bit more difficult to get started with DriveTeX that it ought to be.

Go to drivetex.appspot.com. If this is your first visit, you'll be prompted to authorize DriveTeX to access Google Drive files that you specifically give permission to access.
Visit drive.google.com. (If you just authorized DriveTeX, you might have to reload.) Find a .tex file to edit, right click, "Open With" -> DriveTeX.
Your file opens up in the DriveTeX editor. You can make changes, save and generate a preview.

If you find that your situation doesn't work with DriveTeX (multiple source files, additional LaTeX plugins, etc.), let me know!

Getting started with development

One-time system setup

Install npm
- Windows or Mac: Download NodeJS
- Ubuntu/Debian: sudo apt-get install npm
- Depending on your system setup, you may want to reference this StackOverflow answer about installing NPM global packages without administrative priviledge and this one about node: command not found
npm install -g bower grunt-cli http-server
Install Google Cloud SDK (only needed for pushing to production)
gcloud auth login
gcloud config set project drivetex

Clean repo build

npm install
grunt cleanDeps
grunt

Test locally

cd public; http-server
Visit http://localhost:8080/

Deploy to App Engine

gcloud preview app deploy public/app.yaml --version=3 --promote

Open Source Credits

DriveTeX makes use of many high quality open source libraries, including:

texlive.js (Many thanks to Manuel for his support!)
Polymer
CodeMirror

Disclaimers and Licensing

This is not an official Google product (experimental or otherwise), it is just code that happens to be owned by Google. It is licensed under Apache 2.0; see the LICENSE file for full details.

drivetex's People

Contributors

Stargazers

Watchers

Forkers

wsj1102 e-llp kleopatra999 digideskio pk-codebox-evo expressoman firefoxxy8 shubhamshubhankar yiqideren jamesejnlsn markxp bonomali isabella232 mcgriff3325 dotkwame djouani

drivetex's Issues

Support creation of new documents

Floating action button and toast placement

They're not scrolling down with the rest of the page even though they have position: fixed.

Upgrade polymer

Grunt is unhappy because Polymer 0.5 is deprecated, but 1.0.0 is not backwards compatible.

Enable Team Drive support

Enable read/writing/opening files saved in a Team Drive.

Create an informational splash page

That should link back to the GitHub repo.

Expose the TeX compiler output

Currently TeX compiler output is only available in the JavaScript console. There should be a proper UI element for that.

I was quite eager to try out this code, as I have been looking for a long time for what I think this application provides. However, the instructions for installation that are provided do not seem to work for me. Are they perhaps now obsolete? In particular, the last command: gcloud preview app deploy public/app.yaml --version=3 --promote is what returns errors such as "preview app" now being a deprecated option. When I just type gcloud app deploy public/app.yaml --version=3 --promote, I continue to get errors. Some of the errors suggest that I need to include some kind of [bucket] as part of the options. At that point, I went down a seriously deep rabbit hole, after noticing that the "public" folder was marked as "Migrate to Polymer 1.0" and then trying to learn about Polymer to see if there were alternative ways to get the files installed. Are these files eventually supposed to end up on my Google Drive account? Or reside on the local hard drive of my computer? I'm just confused about what the end-state is supposed to be, and definitely confused as to how to get there. Some help regarding how to install this code (a step-by-step guide would be helpful for a newbie like me) would be greatly appreciated! Thanks!