hikerpig / foam-template-gatsby-kb Goto Github PK

Hi!

I wonder if there would be any way to display documents linked (like pdfs) on the left hand side table of contents and not just the md files.

I don't know if this is doable, but it would be great! 😄

(mmm... I now realise mongodb-cheatsheet is not displaying there either... 🤔 . Need to check that)

Hello!

I'm using this theme to render some notes, and I noticed a weird behaviour when I deployed the page using GitHub pages.

When using wikilinks with an alternative name, like this:

text that references [[pagetitle|a name]]

The page link is correctly handled in Visual Studio, but there are some issues on the deployed website:

1. the alternative name is ignored, and the link text is the whole wikilink text;
2. the linked page always refers the root folder, even if the link refers to a subfolder;
3. the graph does not show the correct references.

If I don't use the alternative name, everything works well.

Here's a real example:

Under the /azure folder I have several documents. In particular, I have azure-storage-redundancy-types.md, azure-virtual-machines.md, and azure-availability-zones.md.

Wrong link generation

The first page references the other two like this:

ZRS replicates your Azure Storage data **synchronously** across **three [[azure-availability-zones|availability zones]] in the primary region**.

and

When creating a storage account, you must select the primary region. The paired secondary region is assigned automatically, based on [[azure-region-pairs]], and cannot be changed.

The VSCode extension generates the following links:

[//begin]: # "Autogenerated link references for markdown compatibility"
[azure-availability-zones|availability zones]: azure-availability-zones "Azure Availability Zones"
[azure-region-pairs]: azure-region-pairs "Azure Region Pairs"
[//end]: # "Autogenerated link references"

Notice that the title of the "Availability zone" link is wrong: it should be "availability zones", not "Azure Availability Zones".

The markdown preview on VSCode is correct:

while the link on the deployed site uses the wrong title:

Wrong link destination

Clicking on the link, you get redirected to a page on the root folder (that does not exist) instead of the correct one under /azure.

Graph

By looking at the graph generated on VSCode, we can see 1 inbound link and 2 outbound links:

While on the deployed site, we have only 1 outbound link:

There is something wrong with gatsby-theme-kb due to the '/foam-template-gatsby-kb' prefix.
Need some effort to sort it out.

I'm not sure this happens only with your template, but the first line of code blocks gets a ½ character indentation, so for this snippet, for example:

```sql
ALTER ROLE <username> SET client_encoding TO 'utf8';
ALTER ROLE <username> SET default_transaction_isolation TO 'read committed';
ALTER ROLE <username> SET timezone TO 'UTC';
``` (need to write this so the code doesn't render in the issue and shows what I use in the md file, please disregard)

I get this result:

You can see that the first line gets a ½ character indentation. Strange!

Also, I don't get any syntax coloring for my code snippets, regardless of the language I pick.

Add mermaid rendering.

When a user adds a mermaid block like

sequenceDiagram
    Alice->>John: Hello John, how are you?
    John-->>Alice: Great!
    Alice-)John: See you later!

The diagram should be rendered automatically.

I don't know what changed in the latest version from February 13th but now all the wikilinks result in a reload.

Additionally, all backlinks are broken and they show multiple times.

I updated package.json and gatsby-config to the latest version, by the way.

I'm not sure how to sort this.

I have a directory structure that looks something like this

• dir1
  • sub_dir1
    • notes.md
  • intro.md
• dir2
  ... and so on

intro.md has a wiki link to notes.md. Foam creates a relative backlink on the markdown page

[//begin]: # "Autogenerated link references for markdown compatibility"
[notes]: <sub_dir1/notes.md> "Notes"
[//end]: # "Autogenerated link references"

This works fine in vscode but the generated pages fails to understand the relative backlinks.

As per the current demo page:

Is it possible to remove the brackets when rendering the web page? :)

I'd like to render math equations with katex and I wonder where I should put the gatsby-remark-katex plugin? Thanks!

Quick answer: point 4 below

Thanks for this theme, it works lovely even for people like myself who don't know Gatsby at all.

I had issues that my custom domain was deleted upon every commit. I had to search and play around a little, but here's the solution in case anybody runs into the same issue (which is probably perfectly logical to people who know Gatsby):

1. When you create your custom domain, Github actually saves that as a textfile called "CNAME" in the root of your page, which in our case is the root of the "gh-pages" branch of your repository.
2. This file is deleted every time the page is rebuilt, so upon every commit.
3. You can place such static components in a folder called "static" in any Gatsby project. In our case, though, the folder structure is a little different.
4. The correct location is to place your textfile CNAME in your master branch where the markdown files are, in the folder _layouts/static/CNAME (you'll have to create "static" and the CNAME file, containing ONLY your domain name, e.g. in my case marc.chehab.ch)

Just in case this helps anybody else. (Quite verbose description to make sure even people who don't know / care about Gatsby follow.)

Thanks again for this wonderful theme and kind regards from Zurich!

Marc

Hi, first thank you for making this awesome template!

I've been trying to setup the blog, but I've been getting build error.

error /vercel/path0/_layouts/node_modules/lmdb-store: Command failed.

The first thing I've tried was removing the yarn.lock file, and it seemed to work.

But my site started breaking down.

1. Dark mode isn't working

2. It seems like db has some sort of issue. Cannot see the category.
   

My solution was specifying the node version in package.json like this. It seems like the project is only compatible with node version 16.12.0.

{
  "name": "foam-template-gatsby-kb",
  "version": "1.0.0",
  "description": "A foam template using gatsby-theme-kb for publishing you knowledge base",
  "engines": {
    "node": "<=16.12.0"
  },

It would be nice to have update in the README file or update in package.json file.

We can assign tags for every bubble.

It would be useful to see those tags on the GitHub rendered page.

Hi, any idea how I can re-organize folders or pin notes, as now it is alphabetically by default?
https://devconwiki.vercel.app/
https://github.com/elgirafo/devconwiki