raghudotcc / simply-jekyll Goto Github PK

Hello,

I just so happened to have been helping a couple peers try to get their sites set up with these theme.

Upon deploying, they get a 404 as Netlify is not setting the deploy settings correctly. More here: https://twitter.com/daretorant/status/1275960558668279808?s=20

Would suggest adding to README or tutorial. Not sure if it’s something you can fix with the repo to have Netlify auto-set them.

Hi, thanks for creating such a great theme. While browsing the template, I encountered something that seems to be a bug, that is, the "text part" of the navigation link is not clickable, for example "<-Home" , the text " Home" is not clickable, even thought when you hover over it , it indicates that it is clickable, but when you click on it , nothing really happens, so I think it might be a bit misleading.

Usually you just add a new jekyll entry under the _posts folder with the correct format which I already did.

I did manage to add one, but can't replicate how it was successfully processed after renaming and moving posts from folders just to get some changes.

Running it on github pages w/o netlify.

Hi Raghuveer,
I love the theme. However, the sytax used for the custom features makes it difficult to author documents in other markdown editors that support wiki-style links (double square brackets) with auto-suggestion (example: Bear, Obsidian, Zettlr, etc). So, somebody who is planning to use your theme will get restricted to authoring using VS Code along with your Notecomplete plugin.

Let me explain the issue with an example. Say, I am authoring a note using Bear app on Mac. And to highlight a snippet of text I write [[This is important::highlight]]. Bear supports wiki-style links using double square brackets. If I click the text within the double brackets, it will imeediately create a new topic with the title This is important::highlight. Same will happen with Obsidian and Zettlr.

By keeping the wiki-style link custom syntax but altering the syntax you are using for other custom features, the limitation of usable markdown editors will be removed and more people will enjoy using your theme.

I have few suggestions regarding the alternate syntax that may be used for custom formatting in your theme:

1. External links: No need to change. You already support all markdown link formats for external links. So, people can use them.
2. Side note/Margin note/Flash card/Partial transclusion: You can either use some other style of brackets or use the footnotes style that many markdown editor supports. I recommend the latter. For example, where the person wants to insert a side note or margin note, he types [^1::lsn] and then enters [^1::lsn] This is left side note in the very next paragraph or anywhere else in the topic. You will render this as a side note or margin note while the other editors will show it as footnotes. For partial transclusion, he types [^2::lsn-transclude] where he wants the transclusion to appear. And then he types [^2::lsn-transclude] [[This is the topic for partial transclusion]] anywhere else in the topic. More information on footnotes syntax is available at https://www.markdownguide.org/extended-syntax/
3. Highlight: I use Obsidian. In that, they enclose the text to be highlighted using two equal signs on both sides. Example ==this is important==. You may adopt it.
4. Wrapping Text: Perhaps another style of bracket or a variation of the fenced code block syntax. For example:

```::wrap
The is the wrapped text paragraph.
/```

Hi! So, I recently tried adding tags to all of my pages (which are all within notes, no posts, I didn't care to differentiate between the two and didn't want to go through the date title naming convention) and nothing is showing up when I am on the tags page despite the fact that I have tags in the YAML front-matter for all of the pages that I want tags in. https://robhaisfield.com/tags/ Please advise! Here is my repo: https://github.com/classicrob/simply-jekyll

Custom markup such as [[Something::rmn]] appears unprocessed in excerpts and transcludes.

It looks like this shouldn't be the case, since

post[0].content` | markdownify | strip_html 

or

post[0].content  | strip_html 

ought to have processed it, but it doesn't.

I really like this theme—thank you so much for making and sharing it! I've been trying to adapt it to work within my existing GitHub Pages site, without using Netlify.

I'd like to have all my posts, notes, backlinks, etc work with a baseurl or folder on my existing site, something like: siteurl.tld/wiki/. I've gotten far enough to have my adaptation output notes with a baseurl. But I've hit the limit of how well I know Liquid programming, so the links from the index and other things don't point to the full url. They skip the baseurl I'm using.

Is that a feature that could be added to the code of your theme?

My ideal structure would be a blend of your theme's features and Tom Critchlow's folder-based digital garden structure. So I'm curious if there's a way to use add your theme's related posts, backlinks, and double bracket link syntax to a wiki that uses multiple folders rather than organizing primarily by tags.

Ends up being displayed as

First image is in my text editor, second is on the actual generated website.

It took me some time to understand the difference between Linked References and Related Posts.

• Linked References are backlinks. In a topic, the Linked References section will list all other topics that have internal links to it.
• Related Posts section in a topic lists all other topics that share the same tag(s) with it.
  The neat stuff is, if a topic has already appeared in the Linked References section, it will not appear again in the Related Posts section.
  I suggest you add the information about Related Posts in the Exploring the features of Simply Jekyll.

Hi! I find having both posts and notes a bit confusing, since I only want to use this to build a digital garden, so simply having notes would be enough, is there a way I can delete the posts part and showcase only the notes? unfortunately, I'm not tech savvy enough the tweak the layout structure myself, please kindly advise.

and thanks again for making such a great project! .

Dear Raghuveer,

It appears that LateX rendering does not work really well. Here is a test snippet if you wish to try it :

Soit deux évènements, A et B. On a :

• $$P(A)$$ la probabilité marginale de $$A$$ (indépendamment de $$B$$)[^1]
• $P(B)$ la probabilité marginale de $B$ (indépendamment de $A$)[^2]
• $P(B | A)$ la fonction de vraisemblance de B - c'est-à-dire la probabilité que B se produise en fonction de la valeur que prend A.

Le théorème de Bayes statue que :
$$P(A|B) = \frac{P(B | A)\cdot P(A)}{P(B)}$$

It works perfectly for me in Obsidian, however in simply-jekyll I get the following :

Do you know how I could solve this problem ? Some LateX is loaded, but it seems to have a hard time with special characters (which LateX is about, unfortunately).

Hi! I'd like to add a category, "Work with Me" to the site header. How would I do that and pick an icon?

I love hover previews, even if they were a bit buggy before. I'd love a fixed version added back in!

Hi! There are a lot of little things in here, like the website title, profile photo, etc. that I need to add in to make the site my own. It would be really helpful for myself and others to have a checklist of items to change!

I have tinkered inside the backlink.html but can't seem to get it to grab "[note name|". So any internal link using this format will not show in the Linked Notes section.

Could you please add an option for Sliding Window Mode (Andy Matuschak's Notes Style).

Even if only a single view on the right would be perfect.

I cannot include new javascript functions that can iterate through the about' and tags pages.

code block in my markdown:

there is no indentation on my rendered page:

is there any solution?

Dear Raghuveer,

I really like your theme, having looked for all of the alternatives digital garden platforms on the market. The tutorial on how to install it is one of the clearest I've read until now.

Having toyed a little bit with it, here is what I think could be improved :

• Notes .md files have tags, but there are not searchable by tags. Maybe the notes part could have a header including a 'tags' just as the home part ?

• It would make more sense to have all of the navigation links in one format than scattered in 3 formats (notes, header, '<- home') :

  • Instead of '<- Home' button inside articles, it would maybe be clearer to have a proper "Home" button in the header, next to "About".
  • Idem for notes, instead of a link, include it in the navigation header should make it easier for the reader to understand the hierarchy of the website. Besides, that leaves some room for a user-defined link, such as, for instance, a CV, a social media link, an alternative blog or a linked-in (or something else !).

I'm not really well-versed in html/CSS, but I may try to see i I can add a 'Home' button to the header.

General questions :

• You mention that it is not an infinite-scroll, but if the blog has 100+ articles, how do readers can attain the 100th post ? Do they have to search in the tags menu ?
• Is internal linking between posts and notes allowed ?
• Is there a way to remove the blog part to have only the notes part ? Some people may already have a blog and just need a platform to publish notes.
  (Edit: found later the classicrob/simply-jekyll fork which does exactly this !)

Thanks for the good work !

First, thanks for the beautiful theme!
The main title seems to be non-responsive for mobile. How can it be fixed (Assuming I would like to keep the same length)?