Simply the ability to place, edit, and sort by timestamps sets it apart from other notes/knowledge systems.
Requires some familiarity with Sublime Text and ST’s quirks, and eventually an ST license is basically a necessity.
If you have time to test and give feedback on any problems, it is always appreciated.
Than all this code+program+data could be decoupled.
That's my main objection to this urtext thing - it's yet another text format, i.e., not really plaintext.
I'm sure you could use it to run your life, but should you, probably not. Better to stick with more standard formats. You can even script those with Python, too...
Sort of like comparing plain HTML to PHP. Appear in similar places, with completely different guarantees.
- a plaintext file format (.urtext),
- a Python library to parse & manipulate said file format,
- a SublimeText plugin,
- a GUI for visualization.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.
I am not and never have been an emacs user, yet I still know of org-mode.
That’s a very strange priority. Why would non-technical users would be interested in a file format and a Python library ?
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.
Edit: damn spell checkers. It typed “the movie of that guy” instead of “the movie of that GUI”.
Then, goes on to present a convoluted node-based system for managing content. Why call it "plaintext" when it clearly has nothing to do with it? Perhaps describing it as some kind of a Markdown alternative, i.e. a markup-language would make more sense?
What is the utility of such a definition? As far as I am concerned, anything I can read with my editor is plain text. That definition is trivially useful on a daily basis. I don't see any point in calling markdown something other than plain text. Because it's just plain text.
And of course, I intend deep disrespect that you had the gall to claim correctness for such obviously arbitrary definitions.
If I can open your file in a notepad and effectively edit it without the format changing or getting corrupted at saving its plain text.
Not plain text: Attempting to edit an .exe file in notepad.
Unfriendly plain text: Minimized javascript where the entire file exists on one line and the human readable elements jumbled together.
Plain text: Your average source code file/html file that attempts to adhere to something around 80-120 columns of text.
Personally, I find 'human readable' to be a better term for your definition and use 'plaintext' to mean either unformatted text (except perhaps with whitespace), or the non-markup text within a marked up document.
Wiktionary suggests that the divide is contextual, with your definition being the 'file format' definition and GP's definition being the 'computing' definition.[0]
A .txt file for notes is plaintext, because the language I'm using doesn't have to be compiled for my goal. Programming languages are not, because the expressed language is compiled into some other target language (machine code).
Markdown is not, because it's compiled into HTML.
A .txt undergoes no transformations from my writing, to its storage, to my later usage of it.
But even "plain text" unicode now breaks a huge number of those assumptions. A number of Unicode characters have defined widths, like all the spaces. Kanji is broadly defined to be twice the width of an English character in a monospaced font, and that's subject to a number of exceptions too. There are markup characters like Right-To-Left, Left-To-Right, and the Arabic Letter Mark. Emoji are not exactly intrinscally non-monochrome, but aren't exactly intrinsically monochrome either (your users may have some objections). Zero-width joiners have complicated semantics that go well beyond just "a zero-width space". You have to handle composite characters e + acute in addition to the e-acute itself, and you have to render arbitrary numbers of them to even remotely properly handle Zalgo text. You have to worry about font glyph support in a way that you didn't in a 256-character world.
Even text with no markup has mandatory markups in it now; they may not be "bold" or "italic" markup but if you want to even remotely properly render them the minimal code necessary to do so is rather more complicated than a minimal bold/italic support. Unicode doesn't really have that "we all agree on the defaults so we can just dump it to the screen and do the simplest possible render and we'll all agree that's what it should look like" anymore.
This is on Linux with Sublime 4 (and 2, didn't try v3).
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.
See, _that_ solution was much better! Unzip, restart, command palette — and there it is! Thanks!
I then scroll down to try find something to read/look at that makes sense. I am met with two bits of information
"just download it to get started"
and
"it's a plain text editor that does stuff many tools you already have do"
So far, things aren't great. Lets look at the demo project, maybe that has some screenshots that really highight it's potential.
"Download the software and just import the demo project"
So, over all, the impression one is left me with is a "just trust me bro, please bro, it's really useful bro, just install it, I swear" kind of message. Personally, I am not just unconvinced by actively wary of this project.
it must be obvious for its creators, but presents quite a wall of features for others to join in.
We can make some more example projects available, will do it shortly. Thanks for the suggestion.
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.
Why not a directory tree of plain text files?
One tool which did this is Tombo:
(unfortunately, the actual page for this is down --- did it make it to Github?)
What urtext - to someone who moved from org-mode to Obsidian - seems to do is
* chain you to a proprietary text editor that does some python interpreting. I wonder which use cases would want me to have my document change itself (or even change its own changing logic).
* highlights 'features' that really do not live in the document itself but rather in the editor's logic (like timestamp handling)
* introduces a complex structure to express 'nodes', which appear to be essentially text anchors.
But anything else, the editing, the easy-UI-free syntax, markdown has done ten years ago.
So it is not a text format, because it lives in a very specific editor. It is not a fully-fledged software package either. It sounds a lot like some sort of macro language which woke up one day and decided to rather be a text repository.
If you (speaking of a general you, not you specifically) wanted to convince people to make the switch, a list of barely described features is insufficient. You need to sell a solution, not a product.
I enjoy and appreciate projects like this, I _WANT_ to like and understand it, but as it stands the information simply isn't there.
This is not a markup format, like markdown proper is, not likr org-mode-as-a-lib with a text format to match.
There are also plenty of "special formats" out there that are really just zipping up a directory tree of something simpler.
nbeversluis•9mo ago