Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/llcc/org-logseq
Org-logseq allows you to open logseq-style page and block link along with Org Mode.
https://github.com/llcc/org-logseq
Last synced: 3 months ago
JSON representation
Org-logseq allows you to open logseq-style page and block link along with Org Mode.
- Host: GitHub
- URL: https://github.com/llcc/org-logseq
- Owner: llcc
- Created: 2021-03-27T11:47:20.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-09-20T02:49:59.000Z (about 1 year ago)
- Last Synced: 2024-07-04T22:57:20.109Z (4 months ago)
- Language: Emacs Lisp
- Homepage:
- Size: 35.2 KB
- Stars: 97
- Watchers: 4
- Forks: 8
- Open Issues: 4
-
Metadata Files:
- Readme: README.org
Awesome Lists containing this project
- awesome-logseq - org-logseq - Another elisp package to work with logseq when using emacs (💡 Workflows and Innovations)
README
#+TITLE:Org-logseq
Org-logseq supports to open [[https://github.com/logseq/logseq][logseq]]-style link (page or block reference), transclusion of referred and embedded blocks using overlays, along with Org-Mode.
* Features
+ Open logseq-style links by native Org-Mode binding (=C-c C-o=, =Enter=, etc). Org-logseq supports:
- Page link: =[[a logseq page]]=
- Block reference: =((6064f6c6-440a-46ca-b8df-59131adab5a1))=
- Block Embed and Reference overlays.
+ Create a blank excalidraw file if necessary, while inserting it at point.
+ Display logseq block references in buffer as overlays:
- =((6064f6c6-440a-46ca-b8df-59131adab5a1))= to =[[id:6064f6c6-440a-46ca-b8df-59131adab5a1][Block heading]]=
- ={{embed ((6064f6c6-440a-46ca-b8df-59131adab5a1))}}= to the content of the referred block.
+ Download images stored in the logseq server to local.
=curl= needs to be installed first.
+ Toggle =contents.org= as a sidebar.* Installation
Org-logseq requires =grep=. Install it using your system tool at first.
Org-logseq package is not on MELPA yet. Currently, the easiest way to install org-logseq is through [[https://github.com/quelpa/quelpa][quelpa]] or [[https://github.com/raxod502/straight.el][straight]] system, or use the =:quelpa= or =:straight= keyword by using [[https://github.com/jwiegley/use-package][use-package]]. In order to make =:quelpa= work well with =use-package=, you need to install [[https://github.com/quelpa/quelpa-use-package][quelpa-use-package]].
- quelpa
#+begin_src emacs-lisp
(use-package org-logseq
:quelpa (org-logseq :fetcher github :repo "llcc/org-logseq" :files ("*"))
:custom (org-logseq-dir "~/logseq"))
#+end_src- straight
#+begin_src emacs-lisp :tangle yes
(use-package org-logseq
:straight (org-logseq :fetcher github :repo "llcc/org-logseq" :files ("*"))
:custom (org-logseq-dir "~/logseq"))
#+end_src
* Getting started1. Set the variable =org-logseq-dir= to your logseq path.
2. =M-x org-logseq-mode= in your current buffer.
Creating a directory-local varible in your logseq directory could be the best way to get it worked in all org files.
#+begin_src emacs-lisp
((org-mode . ((eval org-logseq-mode 1))))
#+end_src
3. Use your native Org-mode bindings to open pages or block references.
* Customization- =org-logseq-create-page-p= ::
A boolean value indicating whether or not org-logseq should try to new a page file at point if it does not exist. The varible defaults to =nil=.
- *org-logseq-block-ref-overlay-p* ::
A boolean value indicating whether or not to display the overlays of =block references= when initializing the Org-Mode buffer.
- *org-logseq-block-embed-overlay-p* ::
A boolean value indicating whether or not to display the overlays of =block embed= when initializing the Org-Mode buffer.
* Changelog** <2021-04-08 Thu>
- Add a =org-logseq-toggle-contents-sidebar= command, to toggle your =contents.org= as a sidebar.
- Fix path quote bug in macOS, [[https://github.com/llcc/org-logseq/issues/1][#issue1]]
* ThanksAll to [[https://github.com/logseq/logseq][logseq]].