I wanted to create javascript-free documentation and articles, but it was annoying to add latex, code, sidenotes, a table of contents, and other niceties. So I created a tool to automate the process. It is very unfinished and can't handle many edge cases, but there are plenty of features to try out.
Learn how to use it from the documentation located at https://triplelog.com/writer/readme.html. To give you an idea of what is possible, that page was created with Triplelog Writer and is entirely javascript-free. The total network load is about 100 KB - most of which is the Katex CSS and fonts.
I think it is really easy to use, but the documentation is probably not good enough yet to make everyone agree with that statement. If you have any questions about how to use it, ask away.
Kudos. With the writer, you're practicing a software packaging and distribution approach that I'd really like to see more projects make use of. From an earlier comment I wrote:
> It would be nice if as part of the zero config effort, programs (esp. programs that aim to be easy-to-use Web-authoring tools) would focus even more on being as close to zero setup/zero installation as possible[...] one should be able to use[...] similar programs by using the browser itself to open and run the program
<https://news.ycombinator.com/item?id=29382091>
Any special reason why you're distributing the writer as a ZIP and not a self-contained HTML file with all the JS and CSS inlined? The experience is much nicer in the latter case (no cognitive overhead of keeping track of what needs to be copied/moved, no fragile directory structure that can be broken by a partial copy/move, etc.) I think this format for local software is currently undervalued and stands to be exploited to greater effect.
(In case your decision to stay off the social coding sites is intentional, kudos again.)
I don't understand your point. The browser eventually has to deal with that stuff whether it's in one bundle or split up with the added overhead of extra HTTP requests/file opens. Being able to more easily avert your eyes and ignore it doesn't change that. There's no magic. If anything, being able to ignore it more easily can actually remove the motivation to wean oneself off the kinds of things that are more convenient than they are strictly necessary.
It's unlikely to matter from a performance perspective. If you're only going to load, it doesn't really matter. If you want to work with the file, all the other stuff will be in your way, for little gain.
Either way, small HTML tools like this I'd rather have dependencies in-lined any day. I'd want to be able to chuck it into a folder for 3 years and be able to use it later even if the dependency hosting goes down.
just loading external files requires some kind of web server, or access to the disk. That's why people like binary files for programs - they don't want to have to compile your code first just to run your app.
I adore this. It's exactly the kind of thing I'd love to make for myself. The finished product is tiny, clean, and useful, and it's a nice contrast from the huge page bloat you see on so many sites. It definitely profits from using built-in HTML elements over JS. Even scrolling through your README was fun.
If this were combined with a static site generator or CMS it could be a real powerhouse. Great work!
Thanks! It is intimidating to build from the ground-up, but it has been worth it.
I'm not exactly sure how I want to integrate this into a more all-in-one solution. Once I check off some more immediate items on my to-do list I will try to figure out the best way to do that.
Perhaps the next step is to create a Javascript-free editor that can be used to create Javascript-free documentation and articles.
The nice thing about Javascript-free documentation and articles is that one does not need a massive, complicated, corporate-controlled web browser with a Javascript engine in order to read them. It would also be nice to not have to use a massive, complicated, corporate-controlled web browser with a Javascript engine in order to create them.
The style looks clean and simple - I like it. It seems to have a good set of presentation tools already.
I would recommend to emphasise less on the drawbacks (i.e. not being completely ready, not documented well enough, etc.). The initial warning should be enough for anyone interested in the project to know it's in its early stages.
Thanks for the kind words! Mainly, I don't really want to deal with pull requests at the moment. Also, I want a dogfooded readme and so having an additional Github readme would be a bit of trouble.
This is quite nice. This is feedback from just using this briefly, but it might be helpful to intercept the tab key and insert spaces when editing, particularly since there's a syntax highlighting section. Maybe also have the preview with iframe option enabled by default as well just to show the fully rendered page.
That aside, I really like how simple and straightforward this is. All of the functionality is clearly labeled and up front. The help documentation is also succinct and immediately useful.
You can check that random checkbox in the Content button to intercept tabs. I know it is not obvious.
I really don't know whether iframes should be enabled by default. It was the default, but I kept clicking endnote links and decided that no iframe is a better default.
Doing it only in Chrome? Having easy buttons for certain snippets? The author didn't make this to be a vim replacement. I don't think this would be a daily or main editor, but seems easy to use in a pinch
Learn how to use it from the documentation located at https://triplelog.com/writer/readme.html. To give you an idea of what is possible, that page was created with Triplelog Writer and is entirely javascript-free. The total network load is about 100 KB - most of which is the Katex CSS and fonts.
I think it is really easy to use, but the documentation is probably not good enough yet to make everyone agree with that statement. If you have any questions about how to use it, ask away.