Client-side GitHub-enabled LaTeX editor and compiler: https://busytex.github.io
- Inspired by awesome Overleaf
- Fully client-side functioning, including project compilation and GitHub integration
- Survives well missing internet connection
- Syntax highlighting
- GitHub integration for both repositories and gists
- Importing papers' LaTeX sources from https://arxiv.org
- Removing TeX comments for preparing paper submissions
- Export and download projects as ZIP and TAR.GZ
- Installing TexLive packages in one click
- Three LaTeX engines: PdfLaTeX, XeLaTeX, LuaHBLaTeX
- Supports BibTeX
- Search in files
- Basic diff tool
- Preview for BMP, PNG, JPG, SVG, PDF
- Share projects using base64-encoded URLs, useful for sharing small MWEs at https://tex.stackexchange.com
- As fast as your local machine, even at conference deadline times
- No browser tracking, not even Google Analytics
- High hackability and minimal codebase size: three JavaScript files, single HTML file, no UI frameworks used
- Both repositories and gists
- Clone
- Push
- Pull
- Publish PDF to Releases
- Ask https://arxiv.org (https://twitter.com/arxiv) to add CORS headers to TAR.GZ export of paper sources
- Ask https://ctan.org to add CORS headers to downloads of package sources
- Ask https://github.com (https://twitter.com/natfriedman) to support uploads of release assets without CORS headers: https://github.community/t/uploading-a-release-asset-possible-from-browser/177582
- Ask https://github.com (https://twitter.com/natfriedman) to add CORS headers to TAR.GZ/ZIP export of repository sources (currently not used): https://github.community/t/feature-request-cors-headers-for-repository-archives/177595
- Better, cleaner, simpler, less cluttered UI design: eliminate unneeded scrollbars, better support for huge resolutions, splitters
- Replace native browser PDF viewer with pdf.js
- Show Git history / all commits
- Figure out SyncTeX support
- Do not scroll to top at rerender, rerender only changed pages
- Render Markdown
- Explore porting Biber to WASM, plk/biber#338, https://github.com/busytex/buildbiber
- Locally cache unpushed projects in IDBFS to recover after browser crash / unintentional tab closing
- Review token / file cache
- When shallow repo support lands in libgit2 libgit2/libgit2#5254, experiment with recreating shallow repos locally using GitHub API
- Some sort of automated functional testing
- Serve locally with serve.py
- Explore bundling everything in a single huge HTML file openable in browser with file:/// protocol
- Explore local machine backend: FS and shell
- More faithful bash (keystrokes and execution)
- Test on Safari, Firefox
- Support Safari mobile on iPhone and iPad
- Licensing: uses compiled busybox (https://busybox.net/), miniz (https://github.com/richgel999/miniz), diff (https://www.openbsd.org/)
- Support opening of busytex site when offline
- Auto-commit to GitHub backup branches + delete them when pushed to non-backup
- TexLive programs compiled to WASM: https://github.com/busytex/busytex
- TexLive data packages
- Busybox programs compiled to WASM:
busybox.js,.config,Makefile - IDE shell:
index.html,busyide.js - GitHub integration:
github.js
- download paper sources from https://arxiv.org
- manual TexLive package installation from https://ctan.org
- publish PDF to https://github.com repos' releases
- https://busytex.github.io/#https://github.com/busytex/busyide/archive/refs/heads/main.zip
- https://busytex.github.io/#https://github.com/busytex/busyide/tree/main/
- https://busytex.github.io/#https://github.com/busytex/busyide
- https://busytex.github.io/#https://gist.github.com/vadimkantorov/43590508854c6e1dac58bcee8d940a8d
- https://busytex.github.io/#https://arxiv.org/abs/1808.00158
- https://busytex.github.io/#data:application/tar+gzip;base64,H4sIAAAAAAAAA+1TS2/TQBDO2b9iLpVACsE2SYx641GBRBAVRKgSRmjsHSerrHetfeShqP+dieuGplWPKYfmu6xnd+abbx62hKKm171jImZkWdaejPtn+50M42GSDtPhmP2SJE5HPRgdVVWH4DxagN6Kij/BkX20iKcQ8/SwN/P/fvHu49eLgaf1EXLsBjwejx+bf5Jko3/zz1KefzqKhz2Ij6DlAZ75/HNhylCT9qVC534lSeN/b9F6WSq6jvKCZlJvb32uoyj30ivavg9uM6U1e2Dwc2O3P1HIGr6g9saaJd8L9LSdGoEbNmpcUBvIBI5KL42+pfimldSc6sAE6QChVJKTOinoldFqAxOc0hWQkJwDUAsoTd1IRXYAP0LTGOtJQBV0y+/Owc3REvMw46LPbIaJK2tq+CT951D0oQluDt509gAeqtvr6hQZpW4cwFTA1xO5JGismVmsHfAqceNQsdZOmgDJHeFIJ/VMEdCayuCxUDSAD8Faro+di6DFzndPxLrP4Yq43D4UsuDf8m1b8FosZSOqet2HReNoNZfl/C6R27ehUegrY2tuw0TqwAErdPWbFF4U1qx4zzspu1K4NE+Oo/qgjaDDF2189/pyAJdkS84E+VkU4Vl7v6t0txtRdGhDyt2875KTFne26X8v/wknnHDCM8ZfeL5NggAMAAA=
| GitHub Integration | |
|---|---|
| BusyTex | BusyTeX has client-side integration with GitHub. This means, you clone the latest version of GitHub repo and branch when you start a BusyTeX session and then you upload updates to GitHub in form of Git commits. GitHub integration is very primitive (e.g. does not support viewing history) |
| Overleaf | Overleaf has paid sever-side integration with GitHub. |
| Documentation | |
| BusyTex | BusyTex has almost no documentation besides this README at the moment :( |
| Overleaf | Overleaf has extensive documentation, including great https://www.overleaf.com/learn resource that has beginner and expert documentation about LaTeX itself. |
| Spell checking | |
| BusyTex | Not supported for now |
| Overleaf | Supported |
| Compilation error reporting | |
| BusyTex | Displays raw compilation logs |
| Overleaf | Presents errors' file and line numbers |
| Project storage | |
| BusyTex | BusyTex does not have its own server-side storage and fully relies on GitHub integration as project storage as well. |
| Overleaf | Overleaf provides server-side project storage and does not require any third-party services for basic work. |
| Project collaboration | |
| BusyTex | BusyTex support collaboration only via GitHub. BusyTex does not support multiple users editing the document or online collaboration. |
| Overleaf | Overleaf supports multiple users editing the document and also supports online collaboration. Overleaf supports GitHub integration as a paid feature. |
| Project compilation | |
| BusyTex | BusyTex compiles projects locally on your machine, in the browser. This requires a good internet connection for first-time downloading ~100 megabytes of binaries / TexLive distribution, CPU resources, ~100 megabytes of RAM. Speed of compilation is limited by your CPU speed / efficiency of WASM support in browser. |
| Overleaf | Overleaf compiles projects server-side. This does not require and significant local resources. This normally means faster compilation times than BusyTex, except for conference deadline times, during these peak load times, compilation may take indefinitely longer or fail. |
| Work recovery | |
| BusyTex | BusyTex currently does not support any recovery of un-committed work (e.g. after browser crash or closing the browser unintentionally). |
| Overleaf | Overleaf does not have this problem because edits are sent to the server in real-time. The only problem for recovery may be during internet connection problems. |
| Open source | |
| BusyTex | BusyTex is open source and lives at https://github.com/busytex/busytex and https://github.com/busytex/busyide |
| Overleaf | Overleaf is open source as well and lives at https://github.com/overleaf/overleaf |
| Hackability | |
| BusyTex | BusyTex is highly hackable, it does not use any UI-frameworks, so hacking is approachable even for people who don't have web development experience |
| Overleaf | Overleaf is also hackable but its codebase is more complex |
| Hosting | |
| BusyTex | BusyTex is completely client-side software and runs on your machine. Besides using BusyTex at https://busytex.github.io, There are multiple options of hosting your own copy of BusyTex. |
| Overleaf | Overleaf requires running server-side services. Besides using Overleaf at https://overleaf.com, one can run your own free copy as a Docker image. Overleaf provides paid service for supporting on-premises version: https://www.overleaf.com/for/enterprises. |
| Expertise | |
| BusyTex | BusyTex is just some tinkering without understanding of LaTeX, TexLive, fonts, CJK specifics etc. |
| Overleaf | Overleaf is developed by LaTeX experts. |
- drop console / xterm.js
- broken
cd
Uncaught (in promise) TypeError: Cannot read properties of null (reading 'startsWith')
at Shell.abspath (busyide.js:106:37)
at Shell.find (busyide.js:1541:34)
at Shell.refresh (busyide.js:1591:22)
at Shell.commands (busyide.js:366:14)
- https://github.com/kawanet/sha1-uint8array/blob/main/lib/sha1-uint8array.ts
- clone from github only a directory in the repo
- https://github.com/GoogleChromeLabs/browser-fs-access
- https://developpaper.com/monaco-uses-vscode-related-syntax-to-highlight-on-the-browser/
- view log + search (bad rename)
- https://stackoverflow.com/questions/34632839/checkbox-marked-with-click-in-link
- https://gist.github.com/jimmywarting/ac1be6ea0297c16c477e17f8fbe51347
- https://github.com/wasmerio/wasmer-js/blob/master/packages/wasm-terminal/src/wasm-shell/wasm-shell.ts, https://webassembly.sh
- https://chromium.googlesource.com/apps/libapps/+/master/hterm/
- microsoft/monaco-editor#44 https://stackoverflow.com/questions/57246356/how-to-highlight-merge-conflict-blocks-in-monaco-editor-like-vscode https://github.com/Symbolk/IntelliMerge-UI
- microsoft/monaco-editor#102
- https://github.com/ochachacha/ps-wasm https://codepen.io/sivadass/details/XZEVmM https://stackoverflow.com/questions/33063213/pdf-js-with-text-selection/43345096 mozilla/pdf.js#11359 (comment) https://github.com/allefeld/atom-pdfjs-viewer
- https://developers.cloudflare.com/workers/examples/cors-header-proxy, https://github.com/Zibri/cloudflare-cors-anywhere
- Store file sha hashes in .git directory
- Ctrl+V, command history
- file tab auto-complete
- ElektraInitiative/libelektra#2873
- Typing is not shown until commands finished processing
- Splitter: https://codepen.io/rstrahl/pen/eJZQej
- autosave
- pseudo-shell quotes
- renaming a current directory + needs a re-cd
- GitHub links: github file, project: https://gist.github.com/btoone/2288960 https://github.com/go-jsonfile/jsonfiddle#usage-1
- http://showdownjs.com/
- preload all media in HTML
- Merge binary files
- timer for auto-save https://stackoverflow.com/questions/5766263/run-settimeout-only-when-tab-is-active
- selection is unchanged when going inside a directory
- Disposing an opened model, do not close upon renaming
- https://api.github.com/repos/busytex/busytex/git/trees/main?recursive=1
- Unify ok/error + initial promp
- Do not close edited file when viewing directory or git
- Better status: how many commits behind master. Check before push
- https://github.com/xloem/emterm
- https://github.com/tomoyukim/vscode-mermaid-editor
- https://github.com/koka-lang/madoko/blob/master/web/client/scripts/editor.js
- https://github.com/koka-lang/madoko/blob/master/web/client/scripts/merge.js
- rate limit error: documentation_url: "https://docs.github.com/rest/overview/resources-in-the-rest-api#rate-limiting"
- message: "API rate limit exceeded for 92.169.44.67. (But here's the good news: Authenticated requests get a higher rate limit. Check out the documentation for more details.)"
- https://github.com/emscripten-core/emscripten/blob/master/src/library_idbfs.js#L21
- http://www.levibotelho.com/development/commit-a-file-with-the-github-api/
- https://blog.jcoglan.com/2017/05/08/merging-with-diff3/
- https://github.com/ywangd/stash/blob/master/lib/git/gitutils.py
- http://gitlet.maryrosecook.com/docs/gitlet.html
- https://mincong.io/2018/04/28/git-index/
- https://medium.com/hackernoon/understanding-git-index-4821a0765cf
- https://stackoverflow.com/questions/25576415/what-is-the-precise-meaning-of-ours-and-theirs-in-git
- https://nitaym.github.io/ourstheirs/
- https://git-scm.com/book/en/v2/Git-Tools-Advanced-Merging
- http://www.jpeek.com/articles/linuxmag/2007-06/
- https://github.com/BlueMagnificent/monaco-tree
- https://medium.com/codingtown/xterm-js-terminal-2b19ccd2a52
- https://github.com/RangerMauve/xterm-js-shell
- emscripten-core/emscripten#2040
- https://stackoverflow.com/questions/59983250/there-is-any-standalone-version-of-the-treeview-component-of-vscode
- https://mozilla.github.io/pdf.js/examples/index.html#interactive-examples
- https://github.com/AREA44/vscode-LaTeX-support
- https://browsix.org/latex-demo-sync/
- http://www.levibotelho.com/development/commit-a-file-with-the-github-api/
- https://blog.jcoglan.com/2017/03/22/myers-diff-in-linear-space-theory/
- http://www.xmailserver.org/xdiff-lib.html
Error: Stray end tag input.
From line 387, column 118; to line 387, column 125
renaming"></input>↩
Error: Stray end tag input.
From line 395, column 154; to line 395, column 161
ttps url"></input>↩
Error: Stray end tag input.
From line 396, column 148; to line 396, column 155
o branch"></input>↩
Error: Stray end tag input.
From line 397, column 185; to line 397, column 192
one/push"></input>↩
Error: Stray end tag input.
From line 411, column 140; to line 411, column 147
res case"></input>↩
Error: Element img is missing required attribute src.
From line 425, column 9; to line 425, column 51
>↩ <img hidden id="imgpreview" class="busyui"></img>
Attributes for element img:
Global attributes
alt — Replacement text for use when images are not available
src — Address of the resource
srcset — Images to use in different situations, e.g., high-resolution displays, small monitors, etc.
sizes — Image sizes for different page layouts
crossorigin — How the element handles crossorigin requests
usemap — Name of image map to use
ismap — Whether the image is a server-side image map
width — Horizontal dimension
height — Vertical dimension
referrerpolicy — Referrer policy for fetches initiated by the element
decoding — Decoding hint to use when processing this image for presentation
loading — Used when determining loading deferral
Error: An img element must have an alt attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images.
From line 425, column 9; to line 425, column 51
>↩ <img hidden id="imgpreview" class="busyui"></img>
Error: Stray end tag img.
From line 425, column 52; to line 425, column 57
="busyui"></img>↩
Error: Stray end tag input.
From line 457, column 103; to line 457, column 110
age name"></input>↩
Error: Stray end tag input.
From line 462, column 109; to line 462, column 116
selection</input></td><
Error: Element thead not allowed as child of element table in this context. (Suppressing further errors from this subtree.)
From line 465, column 25; to line 466, column 23
</tbody>↩ <thead>↩
Contexts in which element thead may be used:
As a child of a table element, after any caption, and colgroup elements and before any tbody, tfoot, and tr elements, but only if there are no other thead elements that are children of the table element.
Content model for element table:
In this order: optionally a caption element, followed by zero or more colgroup elements, followed optionally by a thead element, followed by either zero or more tbody elements or one or more tr elements, followed optionally by a tfoot element, optionally intermixed with one or more script-supporting elements.
Error: Table column 2 established by element th has no cells beginning in it.
From line 461, column 25; to line 461, column 51
<tr><th colspan="2" class="tl">ubuntu
Error: th start tag in table body.
From line 477, column 24; to line 477, column 38
<thead><th class="tl">#line<
Error: Stray end tag input.
From line 489, column 174; to line 489, column 181
release"></input>↩
- Vadim Kantorov: JavaScript
- Ilya: HTML, layout