https://github.com/bphenriques/knowledge-base

Personal Wiki
https://github.com/bphenriques/knowledge-base

gohugo knowledge-base knowledge-management notes org-mode org-roam ox-hugo

Last synced: 3 months ago
JSON representation

Personal Wiki

• Host: GitHub
• URL: https://github.com/bphenriques/knowledge-base
• Owner: bphenriques
• License: mit
• Archived: true
• Created: 2020-05-01T19:08:09.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2023-07-09T17:37:45.000Z (12 months ago)
• Last Synced: 2024-01-07T06:26:05.715Z (6 months ago)
• Topics: gohugo, knowledge-base, knowledge-management, notes, org-mode, org-roam, ox-hugo
• Language: Emacs Lisp
• Homepage: https://bphenriques.github.io/knowledge-base/
• Size: 8.9 MB
• Stars: 26
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.org
  • License: LICENSE

Lists

• awesome-stars - knowledge-base

README

        
* Archived: Migrating out of emacs. Feel free to re-use the [[https://github.com/bphenriques/explorer-hugo-theme][Explorer theme]].

[[https://img.shields.io/badge/hugo-0.85.0-blue.svg]]

[[https://github.com/bphenriques/knowledge-base/workflows/Build%20&%20Deploy/badge.svg?event=push]]

[[https://img.shields.io/badge/License-MIT-blue.svg]]

* Digital Garden

My digital garden is available at [[https://bphenriques.github.io/knowledge-base][bphenriques.github.io/knowledge-base]] and uses the [[https://github.com/bphenriques/explorer-hugo-theme][Explorer Book Theme]].

* How it works

The content is written using ~org-mode~ in the ~org~ directory where each ~*.org~ file is a new note.

Then, using [[https://ox-hugo.scripter.co/][ox-hugo]], each ~*.org~ file is converted to ~*.md~ which will feed ~gohugo~ to generate my digital garden.

* Run locally

1. Export existing ~*.org~ content and run the website locally:

   #+BEGIN_SRC bash

   $ make clean build-content serve

   #+END_SRC

2. Open [[http://localhost:1313][localhost:1313]].

* Contributing

Feel free to send feedback! I look forward to include your insights on my notes :)

* Reference

- [[https://gohugo.io/][Hugo Static Page Generator]]

- [[https://github.com/bphenriques/explorer-hugo-theme][Explorer Book Theme]]

- [[https://github.com/alex-shpak/hugo-book][Hugo Book Theme]]

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

* Inspired by

There are several personal Wikis made by other people that inspired me to make one for me. Follows some notable examples:

- [[https://github.com/jethrokuan/braindump]]

- [[https://wiki.nikitavoloboev.xyz]]

- https://github.com/maggiedelano/digital-garden/

- https://beepb00p.xyz/exobrain/

- http://okmij.org/ftp/

- https://notes.andymatuschak.org/About_these_notes

- http://okmij.org/ftp/

- https://notes.aravindballa.com/

* Theme

The theme is [[https://github.com/bphenriques/explorer-hugo-theme][Explorer]], a theme made by me heavily based on [[https://github.com/alex-shpak/hugo-book][Hugo Book Theme]] with a twist of [[https://github.com/mrmartineau/gatsby-theme-code-notes][Gatsby Theme Code Nodes]] and [[https://www.maggiedelano.com/garden/][Maggie Delano's digital garden]].

I am no front-end expert so I look forward for your help improving the theme if you like it!