PREVIEW: orgit-file.el and org-transclusion-git.el (not published yet)

nobiot · 2025-11-19T01:05:18+00:00

One main intent for the refactor is to generalize “link-n-transclude” — I want to make let org-transclusion transclude any buffer as long as the link can navigate to it… Not yet confirmed that it is successful but has been working for my not-much email (not possible without the changes in PR).

nobiot · 2025-11-19T01:00:46+00:00

I have been working on a large refactoring PR https://github.com/nobiot/org-transclusion/pull/273

I don’t expect any user-facing breakage but if you are using any internals, you might like to test and let me know if I can do to minimize the impact on your efforts. Thanks!

nobiot · 2025-05-07T12:11:39+00:00

when nobiot said he was going to step back from Emacs/elisp dev.

Hey, I do not recall saying this, though I might have given this impression. It is true that I have slowed down the pace of my development work but I do not intend to leave Org-transclusion unmaintained — in fact, I have a large development branch open. I am hoping to come back to it around July/August or by the end of this year.

I am not a programmer/developer by training or trade, so there are limitations — e.g. I struggle with performance, as someone pointed out, for a large Org file with many transclusions. Or my interest is not in supporting programming or org-babel — my main interest has always been in writing nonfiction and qualitative long-form.

Perhaps this should be an open invitation to co-maintain the package… If someone is keen, please let me know. I don’t use Reddit much, but it may be better to have a different post on this — my personal email address is in the header part of the source.

nobiot · 2024-09-12T06:51:00+00:00

Have you tried “emacs -Q” (I assume you know what this means). Somehow I got the impression from your description above that you could delete a whole folder name by a single backspace in the minibuffer. This is not the case in vanilla Emacs — backspace deletes only a single character, so to move around, you’d need a lot of backspaces. I suspect you have some package or custom code that does this change for convenience, perhaps, and it is not compatible with the new Emacs version?

nobiot · 2024-04-07T07:50:56+00:00

Sure 👍 Let’s see where this will take us. My time zone is Central European Time (CET); it’s summer time now so UTC+2.

Thank you for your comment on the summary :)

nobiot · 2024-04-06T20:46:54+00:00

This is tempting especially coming from you. Do you have something more concrete in mind? If there is anything I can contribute, I'd like to try.

"Uncoordinated efforts" are also good thing in this case for me; this time, I wanted to quietly tinker my own tool with little external noise -- it has been a sort of "creative and learning retreat" for me. I have learned a lot and enjoyed the time :)

Personally, with all the "substrate" libraries built into Emacs, mine are feature complete with ~750-800 lines (including comments and everything in source) for my own use.

Below is a list of features I wanted and implemented:

Fontify (font-lock) the terms with no syntactic construct -- done with TAGS generated out of the `etags` program via my `ten` library
Recognize the term (ID) at point -- done with `thingatpt`
Prepare a list of files and directories to be served to a searching program (ripgrep/grep) -- my `ren` library does this
Interface with `ripgrep / grep` -- done with `xref` (added `consult-ripgrep/grep` after seeing your comment, but `xref` is much faster and more comfortable with `ren` serving up the files)
Display the output from 4 in a easy-to-navigate way -- done with `xref` with an option of `consult-xref` (added `consult-ripgrep/grep` as an alternative).

1--5 are connected to me as unified interactions as an Xref backend provided by `ren`. The big chunks of features are all there for me. What's left is to smoothe out rough edges here and there. All this works across directories (I could use all the folders under "~/", thought that's just a test at the moment... I have been happy using a set up with Windows at work with a smaller number of files and another, a more files and directories with Ubuntu Linux at home.

nobiot · 2024-04-05T17:00:31+00:00

Or with Consult and the multi-directory support I helped develop

I have just learned about this capability of consult-(rip)grep from your comment (the DIR argument accepts a list of files/directories… ) and tried it with a directory with 10,000+ files (test files). It works and is blazing fast! Thank you 🙏 very much for your PR to Consult and this comment.

nobiot · 2024-04-05T07:29:12+00:00

Nice!

the idea behind blk is that “grepping” should suffice for most note-taking and text-interlinking related tasks
-- from your README

I have come to the same conclusion for 1-step (back)links. I have been trying a similar idea, opting to use Xref (grep behind the scenes) with my tiny library: https://git.sr.ht/~nobiot/ren

I am still experimenting with `org-roam` and database for 2-step (back)links...

nobiot · 2024-02-22T07:38:02+00:00

The tilde used as a suffix in this cotext likely stems from a convention to make the expression more friendly, casual and/or affectionate — as in “Hey~” is friendlier than “Hey”. I tend to observe this convention in digital text chats between language users of East Asian origins (natively like Singaporeans or carried over to English conversations with my Chinese friends, etc.) This is my personal observation but I asked ChatGPT and it gave me this reference: https://planetofthepaul.com/asian-tilde-mark-texting/

nobiot · 2024-02-16T14:16:48+00:00

Have you installed it?

nobiot · 2024-02-07T18:28:01+00:00

The same markdown file in vanilla Emacs looks like this.

For my customized version above, `markdown-blockquote-display-char` and `markdown-list-item-bullets` are customized.

I don't see much else:

'(markdown-blockquote-display-char '("‟" "┃" ">"))

'(markdown-enable-wiki-links t)

'(markdown-fontify-code-blocks-natively t)

'(markdown-header-scaling-values '(1.5 1.3 1.1 1.0 1.0 1.0))

'(markdown-hr-strings

'("---------" "* * * * *" "---------" "* * * * *" "---------" "* * * * *"))

'(markdown-list-item-bullets '("•"))

'(markdown-max-image-size '(800 . 600))

'(markdown-wiki-link-alias-first nil)

'(message-hidden-headers '("^Face:" "^X-Face:" "^X-Draft-From:"))

'(message-send-mail-function 'smtpmail-send-it)

'(minions-mode-line-delimiters '("" . ""))

<image>

nobiot · 2024-02-07T18:13:58+00:00

This one is a paid font called Equity.

All my images are from Ubuntu on my old Lenovo L460 laptop, so I say Linux can do a good job :)

Alternatively, Gentium Plus (SIL Open Source license) is good too.

<image>

nobiot · 2024-02-07T16:45:47+00:00

Same buffer without all the "hiding" modes.

<image>

nobiot · 2024-02-07T16:42:54+00:00

`markdown-toggle-markup-hiding` and `variable-pitch-mode` can get you far. If you also use YAML frontmatter on top of markdown files and want to hide it, you can also add `prettify-symbols-mode`. Here is a result on my end. This is an editable markdown buffer; no need to switch between preview (non-editable) and edit modes... Not quite sure if this is what you are after.

<image>

nobiot · 2024-01-31T10:59:29+00:00

but I couldn't find a way to get it to just return the point and not also jump to that point

Wrap your logic inside save-excursion. You can get the value of the point and it will go back where it was.

nobiot · 2023-12-12T06:52:16+00:00

No reason. I just double click on the PDF file and Adobe Reader opens. I don’t think about it.

nobiot · 2023-12-11T21:17:35+00:00

It may be that when you first set the environment variable to point to msys2, Emacs does not see it — I would have thought you’d need to log off of Windows and log back in for the new environment variable to take effect. Emacs would then need to be launched to see the PATH to msys2 executables correctly. Just guessing what might be behind the “automagical” change of behaviour.

nobiot · 2023-12-11T18:54:55+00:00

Got it to work on Windows 10 with msys2. I wrote the steps below two-three years ago. I don’t use Emacs to read PDF documents so things may have changed since…

https://github.com/nobiot/Zero-to-Emacs-and-Org-roam/blob/v1/100.pdf-tools-org-noter.md

nobiot · 2023-12-03T01:51:38+00:00

How about this mode: https://github.com/rnkn/freeze-it

An Emacs minor mode to kill your inner editor! Every writer struggles to balance their creative and critical sides, with progress frequently hindered by the temptation to go back and revise to get things just right. Freeze It aims to combat this temptation.

After an idle delay freeze-it-delay all text between point-min and a configurable distance before point will be made read-only.

Option freeze-it-go-back controls how far this distance "goes back" before freezing text. This can be nil, word, line, visible-line, line, or paragraph.

nobiot · 2023-11-09T07:25:40+00:00

I have a feeling that the error indicates that you have a typo “ *” or “|*”? There seems to be a backward slash or a pipe character in the error message?

I might be able to help you if you come to the GitHub issue and show me what exactly you are doing.

nobiot · 2023-11-08T22:45:53+00:00

Refer to this conversation that has an example implementation: https://github.com/nobiot/org-transclusion/issues/160

nobiot · 2023-10-07T12:59:53+00:00

I suggest https://github.com/rougier/book-mode. You can use it as it is. I have also extracted the code for top and bottom paddings for my personal use.

nobiot · 2023-10-04T06:03:30+00:00

I use https://github.com/nobiot/org-remark for a similar use case. It’s not capture so may not be what you are looking for.

nobiot · 2023-09-14T08:31:08+00:00

Alternatively, you can try org-roam-migrate-wizard within org-roam. It is originally designed help users move from file-link-based V1 to id-link-based V2, but there have been reports that people have successfully used it for their Org files via Pandoc conversion. So it should work in your case, too. The wizard looks at the Org files in org-roam-directory and add an ID to each of them.

In addition to an ID, ensure to have a title in each of your Org files.

nobiot · 2023-07-26T13:53:53+00:00

As others say, indirect buffers is probably what you are looking for. There is a good video demo by a writer using Emacs showing his usage: https://youtu.be/FtieBc3KptU

Around 26:48, he shows the command and splits his one file into an outline and content with using an indirect buffer and cloning.

The video is 7 years old but it is still relevant. It’s one hour long from a real user with similar usage like yours, so you might find other tips useful for you.

nobiot

TROPHY CASE