News for hackers. Stuff that matters.
Re:Urtext: The Python plaintext library for people who've tr... by codethief on Monday May 05, 2025 @04:04AM (#43892833)
Took me a while to understand what this is about – the website calls it a "library" but shows a GUI(?!) As far as I understand it is:

  - a plaintext file format (.urtext), 
  - a Python library to parse & manipulate said file format,
  - a SublimeText plugin,
  - a GUI for visualization.
Re:Urtext: The Python plaintext library for people who've tr... by nbeversluis on Monday May 05, 2025 @04:25AM (#43892946)
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.

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).
Re:Urtext: The Python plaintext library for people who've tr... by nobodywillobsrv on Monday May 05, 2025 @04:01PM (#43898880)
Is urltext a bit like what tiddlywiki was back in the day?
Re:Urtext: The Python plaintext library for people who've tr... by nbeversluis on Thursday May 08, 2025 @03:51PM (#43930585)
It was inspired by that and similar wiki-like tools.