https://github.com/grtcdr/liaison

Generic Git URIs for Org Mode.
https://github.com/grtcdr/liaison

emacs library org-mode ox-html

Last synced: over 1 year ago
JSON representation

Generic Git URIs for Org Mode.

• Host: GitHub
• URL: https://github.com/grtcdr/liaison
• Owner: grtcdr
• License: gpl-3.0
• Archived: true
• Created: 2022-11-01T16:09:04.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2023-07-02T15:37:05.000Z (almost 3 years ago)
• Last Synced: 2025-02-12T14:55:41.645Z (over 1 year ago)
• Topics: emacs, library, org-mode, ox-html
• Language: Emacs Lisp
• Homepage: https://liaison.grtcdr.tn
• Size: 1.32 MB
• Stars: 7
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.org
  • Changelog: CHANGELOG.org
  • License: LICENSE

Awesome Lists containing this project

README

          
#+TITLE: Liaison

#+OPTIONS: toc:nil

Liaison, [[https://git.sr.ht/~grtcdr/liaison][which has recently migrated to SourceHut]], generalizes and

automates the process of linking an /HTML/ document to its

corresponding source document originally written in the /Org/ markup

language. Its purpose is to generate URLs that point to a specific

page in a Git web interface, e.g. the tree, blob, blame, edit pages,

and more.

For more information on how to install and integrate the package in

your project, you are encouraged to read the [[https://grtcdr.tn/liaison/manual.html][online manual]].

* How does it work?

Check out [[https://grtcdr.tn/liaison][the project's website]] to get a feel for what the package can

do. Although it may not seem like it, the hompage gives a

comprehensive tour of the functionalities of the package.

* Who is it for?

Anyone with a blog or documentation website built on top of the

=org-publish-project-alist= variable provided by the built-in

=ox-publish= library or high-level static site generators such as

[[https://ox-hugo.scripter.co/][ox-hugo]].

* What web interfaces does it support?

- GitHub

- GitLab

- SourceHut

- Gitea

- cgit

When applicable, custom instances are supported too.

* Who's using it?

- [[https://grtcdr.tn][grtcdr.tn]], in the postamble of blog posts and documentation files.

- [[https://ushin.org][ushin.org]], in the postamble of every page.

If you are using Liaison in your project and would like to be included

in the list, feel free to [[mailto:tahaaziz.benali@esprit.tn][contact me]].

* Citing

If your research involves this project in any way, you may cite it

like so:

#+begin_src bibtex

@misc{ab22liaison,

  author = {Aziz Ben Ali},

   title = {Generic Git URIs for Org Mode},

     url = {https://grtcdr.tn/liaison/},

    year = 2022

}

#+end_src