HNHacker News
TopNewBestAskShowJobs

nbeversluis

57 karma · joined February 8, 2023

Developer
submissionscomments
nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
Glad it worked out, thanks for the persistence. Glad to receive any feedback or questions either here or via the support form on urtext.co if you prefer.
nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
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/
nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
Yes, similar, and Leo was one of many inspirations.
nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
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.
nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
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.

nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
This was great feedback, thank you. One of us in the development group is looking at NeoVim now as another possible implementation.
nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
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.
nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
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).
nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
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.
nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
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.

nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
Similar, thanks for asking. Org-mode was one of many inspirations.
nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
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.
nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
It was inspired by that and similar wiki-like tools.
nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
This was helpful feedback, thank you. Removed the video and added examples instead, and will be adding more.
nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
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.

nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
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.

nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
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.
nbeversluis··on Urtext: The Python plaintext library for people who've tried everything else
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.