Re:Urtext: The Python plaintext library for people who've tr...
by slooonz on Monday May 05, 2025 @08:07AM
(#43894182)
> 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 ?
Re:Urtext: The Python plaintext library for people who've tr...
by nathan_compton on Monday May 05, 2025 @07:13AM
(#43893752)
Seems like a very concise pitch would be "org-mode for Sublime" and that would explain it adequately for most emacs users.
Re:Urtext: The Python plaintext library for people who've tr...
by cbarrick on Monday May 05, 2025 @07:24AM
(#43893809)
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.
Re:Urtext: The Python plaintext library for people who've tr...
by zahlman on Monday May 05, 2025 @12:05PM
(#43896525)
I've heard of it many times, but have basically no conception of what it actually is.
Re:Urtext: The Python plaintext library for people who've tr...
by codethief on Monday May 05, 2025 @02:05PM
(#43897755)
It's a file format / markup language (think Markdown but more feature-rich) with excellent editor support in Emacs.
Re:Urtext: The Python plaintext library for people who've tr...
by coldtea on Monday May 05, 2025 @06:50PM
(#43900189)
That's like describing a swiss army knife as a "beer opener"
Re:Urtext: The Python plaintext library for people who've tr...
by mmooss on Tuesday May 06, 2025 @02:16AM
(#43902269)
Is it 'org-mode'?
Re:Urtext: The Python plaintext library for people who've tr...
by nbeversluis on Thursday May 08, 2025 @03:53PM
(#43930616)
Similar, thanks for asking. Org-mode was one of many inspirations.
Re:Urtext: The Python plaintext library for people who've tr...
by nbeversluis on Thursday May 08, 2025 @04:08PM
(#43930770)
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.
Re:Urtext: The Python plaintext library for people who've tr...
by em-bee on Monday May 05, 2025 @08:40AM
(#43894459)
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.
Re:Urtext: The Python plaintext library for people who've tr...
by nbeversluis on Thursday May 08, 2025 @04:01PM
(#43930691)
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.
Re:Urtext: The Python plaintext library for people who've tr...
by nottorp on Monday May 05, 2025 @09:58AM
(#43895211)
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”.
Re:Urtext: The Python plaintext library for people who've tr...
by nbeversluis on Thursday May 08, 2025 @03:49PM
(#43930564)
This was helpful feedback, thank you. Removed the video and added examples instead, and will be adding more.
Re:Urtext: The Python plaintext library for people who've tr...
by zahlman on Monday May 05, 2025 @12:04PM
(#43896521)
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.
Re:Urtext: The Python plaintext library for people who've tr...
by nbeversluis on Thursday May 08, 2025 @03:59PM
(#43930674)
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).
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.