Yes, similar, and Leo was one of many inspirations.

Thank you for the feedback, very helpful. We are trying to solve this to make something close to a single-step install. The package at https://packagecontrol.io/search/urtext is now an installer only. See the readme at https://github.com/nbeversl/urtext_sublime_installer for information. It installs another package control channel and pulls the latest from there. Obviously this is not ideal, but it is the best we can do at the moment, unless you want to use Git and do it manually. Glad to hear any problems you run into.

Thank you for the links.

I think I'm too dumb for this. I have only installed Sublime Text 4 because of Urtext, and I have no prior experience with the editor. At all.

It is unclear to me what I should do with the `sublime_urtext_installer.py` file, so I jumped to the “run these steps manually” steps instead. This seems to be exactly what I did before with no luck, and this time is no different. Having followed the steps, the last step always only offer me to install “Urtext”, not “UrtextSublime” and if I do that there will be zero entries with “Urtext“ in the command palette afterwards.

I will be happy to try the `sublime_urtext_installer.py` road, but I simply don't know what to do with that file.

Cheers.

If you have the patience to try again, we are eliminating any package control channel from the process, it is now a .ZIP file download. See if these steps are any more successful: https://urtext.co/setup/sublime-text/

My pattience is infinite. :)

See, _that_ solution was much better! Unzip, restart, command palette — and there it is! Thanks!

We have had trouble with package control, unfortunately. The package control bot was down for over two months without any notification to developers, and we did not know why the small pool of test users were unable to pull updates during this time. As a result, the package at https://packagecontrol.io/search/urtext is now an installer only. See the readme at https://github.com/nbeversl/urtext_sublime_installer. It installs another package control channel and pulls the latest from there. Obviously this is not ideal. We tried to solve it with Package Control maintainers to no avail.

If you have time to test and give feedback on any problems, it is always appreciated.

Yes, inspired by org-mode and similar to it in some respects. It does have Python block execution, but the syntax is not that of org-mode.

It was inspired by that and similar wiki-like tools.

There is a "starter project" with self-documenting examples that can be created from the Sublime Text command palette: https://urtext.co/setup/starter-project/

We can make some more example projects available, will do it shortly. Thanks for the suggestion.

i'd like to see examples before i install something.

This was helpful, thank you. We replaced the video on the homepage with some inline examples of at least syntax, and will soon post some examples of "real world" use.

Curious, how important would it be to you that the examples be readable with syntax highlighting and full tabbing/formatting in the browser? It is somewhat complicated to accomplish this and; present examples are mostly using manual inline styling.

Would examples projects on Github be helpful? It presents the same problem for syntax highlighting.

i think having examples at all is much more important than worrying about syntax highlighting. example projects on github or anywhere else would also be great. the format would probably even lend itself to use the explanations as your example text.

The documentation should be made clearer in that case. A priority was to make setup and trial easy for non-technical users. It seems now that to technical users it is unclear what is offered.

From your list it is first and mostly:

1. a plaintext file format (.urtext) - specifically, a syntax

2. a Python library to parse & manipulate said file format (syntax)

These in turn require some implementation within an editor. Sublime Text was chosen for its built-in Python interpreter, its package install system, and its GUI features that together comprise a low barrier to entry.

Thanks for the feedback, we will try to make this clearer.

> A priority was to make setup and trial easy for non-technical users

That’s a very strange priority. Why would non-technical users would be interested in a file format and a Python library ?

Seems like a very concise pitch would be "org-mode for Sublime" and that would explain it adequately for most emacs users.

It would also explain it for non-emacs users.

I am not and never have been an emacs user, yet I still know of org-mode.

I've heard of it many times, but have basically no conception of what it actually is.

It's a file format / markup language (think Markdown but more feature-rich) with excellent editor support in Emacs.

That's like describing a swiss army knife as a "beer opener"

It was inspired partly by org-mode, but org-mode can be quite difficult for non LISP-users. This project has the priority of low barrier to entry, with a lot of the Python-specific functionality coming out-of-the-box, and abstracted away underneath the syntax of "frames and calls." Even those are can be used only as desired; as another poster mentioned, the project has wiki-like functionality without going any deeper than the basic syntax.

Is it 'org-mode'?

Similar, thanks for asking. Org-mode was one of many inspirations.

I think you really need a separate pitch and documentation for "technical" and "non-technical" users. The editor system (GUI + Sublime Text integration) is effectively a separate project from the underlying format + library.

This is helpful feedback, thank you. We are working on this possibility, and explaining a clearer separation between, as another poster mentioned, the Python library (which is headless) and a specific implementation (which requires some sort of text view that may have GUI features).

i searched for examples but could not find any. i found the syntax page which describes the elements, but it doesn't tell me what i can do with them or why i would use them. each element links to a separate page with more details, but even there i feel questions are left unanswered.

you explain the syntax but not the semantics.

i suppose that maybe if i had tried some alternatives then i would not need the semantics because i'd be already familiar with them.

This was helpful, thank you. We have replaced the home page video with inline examples of the syntax instead, and will be adding some real-world use examples in addition.

Funny maybe, but when I opened the site and the movie of that GUI opened and started to play I got very confused, tried to click on things and even maybe got a bit motion sick because it was going along independently of what i clicked :)

Edit: damn spell checkers. It typed “the movie of that guy” instead of “the movie of that GUI”.

This was helpful feedback, thank you. Removed the video and added examples instead, and will be adding more.

Correct that it needs an editor, but it need not be GUI. Everything can be done in text buffers only. The library is newly presented and there is not an implementation in VIM, but it would be a good choice and would not take long to implement. I will make a note that there is interest.

100%. This seems like something the Neovim crowd would get behind. They can be a helpful bunch too - it might be worth just starting a branch and asking for contribution assistance.

This was great feedback, thank you. One of us in the development group is looking at NeoVim now as another possible implementation.

Urtext /ˈʊrtekst/ is an open-source library for plaintext writing, research, documentation, knowledge bases, journaling, Zettelkasten, project/personal organization, note taking, a lightweight database substitute, or any other writing or information management that can be done in text format. With some Python knowledge you can practically run your entire life from Urtext.