sharelatex-git-integration-unofficial is a Python 3 script that can act as a free replacement to ShareLaTeX's github integration.
With sharelatex-git-integration-unofficial, you can use any folder in a git repository to keep your ShareLaTeX project and track its changes. The script automatically downloads the most recent files and does git commits for you. You can also specify an optional commit message. It will even create your git repository if you haven't yet!
sharelatex-git-integration-unofficial works in public and private repositores alike, as well as on your own hosted instances. With it, you will instantly be able to track the changes to your project, be it a thesis, a paper or something entirely different.
Install instructions can be found here. A Quickstart guide can be found here. Other example usage can be found here.
It should run in any operating system (Windows, Mac OS X, Linux).
- Quickstart (Getting Started)
- How do I install/uninstall it?
- How does it work? Is this legal?
- Can I also push changes from git to ShareLaTeX? (e.g. do a git revert and change my project)
- The URL is too large...can't I initialize the application with something else?
- If it does commits for me, won't it commit other files on my git tree?
- Can it also push the commits for me?
- I want to change the project. How can I do that?
- Why not use the premium version?
- Example Usage
- What are all the options?
(TOC created with the help of gh-md-toc)
This section tells you all you have to know to get started using sharelatex-git-integration-unofficial (from now on abbreviated sharelatex-git). It's really easy!
-
First, install the script.
-
Change directory to the folder where you want to keep your ShareLaTeX files. This folder can already be a part of a git repository, but sharelatex-git will create a repository if it doesn't exist yet. E.g.
cd <my desired ShareLaTeX project folder> -
Copy the URL address of your ShareLaTeX project (we'll use https://www.sharelatex.com/project/56147712cc7f5d0adeadbeef as an example).
-
Invoke sharelatex-git with that address
sharelatex-git https://www.sharelatex.com/project/56147712cc7f5d0adeadbeef -
All done! Whenever you want to add a new commit with your updated ShareLaTeX project changes, come back to this folder and run
sharelatex-gitYou don't need to pass the URL ever again. You can also pass commit messages to better track your changes. For that, use the
-moption as so:sharelatex-git -m "Started the Experimental Validation section"
Isn't that simple?
Just clone the repository and run install.sh, or uninstall.sh to remove it. It will install to /usr/bin, but you can change this by passing your desired prefix to install.sh, as an argument. This will install the sharelatex-git-integration-unofficial application/script and make it available for you to run.
pip install requests bs4
git clone https://github.com/Jorl17/sharelatex-git-integration-unofficial
cd sharelatex-git-integration-unofficial
chmod +x install.sh uninstall.sh
sudo ./install.sh
pip install requests bs4
git clone https://github.com/Jorl17/sharelatex-git-integration-unofficial
cd sharelatex-git-integration-unofficial
chmod +x install.sh uninstall.sh
sudo ./install.sh /usr/local/bin
./uninstall.sh
./uninstall.sh /usr/local/bin
sharelatex-git-integration-unofficial doesn't do anything illegal. In theory, you could do what sharelatex-git-integration-unofficial does on your own. You would download all the files, put them in your folder, and then run a couple of git commands.
Unfortunately, this is not supported. In theory, this could be done, but at the moment it is not implemented.
However, you can do all the changes you want in your repository, and then simply copy the affected files manually to your project. It's kind of a hassle, but unless you're always deleting what you write, 99.99% of the time you'll just want to track the changes -- that's what this application is for.
If this really annoys you, open up an issue!
Well, yes! If your URL is https://www.sharelatex.com/project/56147712cc7f5d0adeadbeef you can happily just pass 56147712cc7f5d0adeadbeef (the "project ID") and it will work. However, since you only really need to pass the URL once, I don't really see the point. Notice that this only works for projects hosted on the ShareLaTeX server. If you run your own, you really have to pass the URL to the application (how would we know where your server is hosted?)
No, not at all! If you see this behavior, it's a bug, please report it. The only files that sharelatex-git-integration-unofficial should include in its commits are the files associated with your project and, occasionally, your .gitignore file.
This is implemented, but it is experimental (-p option). It should work if you have passwordless pushing in your git settings (be wary of https clone links!). Otherwise, it currently blocks and you have to kill it with a CTRL+C. If you really need this feature, be sure to open up an issue and I'll get straight to it (or better yet, send me a patch!).
If you made a mistake, or if you simply want to change the project ID, you can invoke sharelatex-git with the new ID (as if you were starting a new project). A conflict will arise and you will be asked if you want to use the new ID. Note that this won't delete the previous project's files! Do that on your own!.
I really like ShareLaTeX, but I'm not willing to pay for just this particular feature that I can legally automate on my own. It's your choice :)
Here are a couple of examples on how to use sharelatex-git-integration-unofficial. Most of these are covered in the Quickstart guide.
That's easy! Do
sharelatex-git
Yes, that easy! You can personalize the commit message (e.g. to specify what you changed in the document) with the -m option
sharelatex-git -m "Started the Experimental Validation section"
You can use the -p option:
sharelatex-git -m "Started the Experimental Validation section" -p
Another easy one if you use -n,--no-commit! Do
sharelatex-git -n
-h, --help show this help message and exit
-m MESSAGE, --message=MESSAGE
Commit message (default: "").
-p, --push Push after doing commit (default: don't push)
[EXPERIMENTAL]
-n, --no-commit Don't commit, just download new files.
-e EMAIL, --email=EMAIL
E-mail needed for login
--password=PASSWORD Password to authenticate with the given e-mail