oinam-jekyll
furo
oinam-jekyll | furo | |
---|---|---|
4 | 7 | |
27 | 2,466 | |
- | - | |
4.6 | 8.6 | |
5 months ago | 3 days ago | |
CSS | Sass | |
MIT License | MIT License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
oinam-jekyll
-
Ask HN: Preferred Platform to Blog
As we are on HN, I'm going to assume that you are comfortable using Github and can follow instructions.
Write it on Github and publish on your domain. Github has an option for you to fire up a web-editor (VSCode) right there in the browser with the keyboard `.` (<- that is a period). So, you can write right then and there (I do it quite often these days).
When publishing, choose a Jekyll theme of your choice from Github Pages[1]. Your focus now are just enough plain text (Markdown).
If you want to bring it to your desktop/device, just checkout the repo and write. These days, my choice is to just write in Obsidian and don't even try to run Jekyll.
What do you get out of this? The simplicity of focusing on your writing with almost Plain Text while Github takes care of your theme, hosting, SSL, and custom domain[2].
Of course, you will need to book a domain and own it. I like Cloudflare[3] that takes care of pretty much everything you want to do with a domain for free. If you so wish, you can even let Cloudflare do the page building[4] and hosting while you keep Github for the source.
Plug: I build a super simple Jekyll theme[5] just so I can do this. I wrote an article about it on my website[6].
1. https://pages.github.com
2. https://docs.github.com/en/pages/configuring-a-custom-domain...
3. https://www.cloudflare.com
4. https://pages.cloudflare.com
5. https://oinam.github.io/oinam-jekyll/
6. https://brajeshwar.com/2021/brajeshwar.com-2021/
- A simple, clean, and minimal Jekyll Blog Template – easy deploy to GitHub Pages
-
SimpleCSS: A Classless CSS Framework
Simple.css is a well done classless 'framework'. I stumbled on it a while back and started using it and thought this can be my go-to styles for tit-bits of websites that I do for landing pages, family websites etc. However, this is pretty opinionated (including some animations) and I had to abandon it. But I remained inspired by its simplicity and forked my own[1] broke it down. I broke it down to the most basic, but then can be built on top of it -- progressively get a website "designed" far enough but not further.
If you are into these simple classes, check out Drop-in Minimal CSS[2] and choose the one that fits your need.
Simple.css is from an interesting guy, Kev Quirk[3], whose 512kb[4] website was on Hackernews a while back (don't recollect if it was a story or a comment). Hi Kev, if you are around.
If you are spinning up a simple website with classless styles, perhaps it is a good idea to add a print styles and I like Gutenberg[5] for that.
1. https://oinam.github.io/oinam-jekyll/
2. https://dohliam.github.io/dropin-minimal-css/
3. https://kevq.uk/about/
4. https://512kb.club
5. https://github.com/BafS/Gutenberg
-
Pollen – A library of CSS variables inspired by TailwindCSS
Ah! This is brilliant. There are quite a few comments here about pitching this against other CSS frameworks or the actual use of this.
This is not a stand-alone framework or anything of that start. Treat as one of your scaffold components for your styling framework. Tailwind does this with their tailwind.config.js and is more of raw CSS design tokens. I just wish their commercial TailWindUI[1] make it easy to make use of it the better way.
I wish I saw Pollen a few months ago. I wanted to do an effortless design for my personal website and stick to as plain vanilla CSS as possible. The best way was to rely on CSS-Variables. I did do it from scratch[2]. It works though it is pretty hacky, and I'm not too concerned. Right now, I can swap few values and have an entirely different color scheme - light/dark version of my own, Nord Theme[3], and I will keep adding me whenever I get bored. I can even tweak the rhythms and spacing to my liking with just the variable. You should check out the demo[4] or look at the source[5] (wip).
For those who find this interesting, you should check out another interesting one I discovered a few months back -- css-media-vars[6].
1. https://tailwindui.com
2. https://github.com/oinam/oinam-jekyll/blob/main/_includes/cs...
3. https://www.nordtheme.com
4. https://oinam.github.io/oinam-jekyll/
5. https://github.com/oinam/oinam-jekyll
6. https://github.com/propjockey/css-media-vars
furo
-
Can someone help me understand "documentation generators" and the purpose of Sphinx?
Sphinx has more and in my opinion better themes (especially the popular Furo them). I also think it's better for handling large and complex sites. It's way more extensible. That there are far more Sphinx users means that you're more likely to have community support if/when you run into issues.
-
Can you select themes for rustdoc?
My company uses sphinx, in particular the furo theme: https://github.com/pradyunsg/furo. I'd like to use something like this to start documenting our Rust repositories. Is this possible on stable?
-
[D] What JAX NN library to use?
On another note, what did you dislike in Sphinx ? I found it pretty easy to work with until now and there are quite nice themes, like Furo (https://github.com/pradyunsg/furo), which is actually pretty similar to your current docs theme. I used it recently for one of my projects (see https://francois-rozet.github.io/piqa/piqa.psnr.html).
-
New Sphinx theme
reminds me a lot of Furo which is used by big names such as urllib3, pip, attrs, psycopg3, black
- Furo: A clean customizable documentation theme for Sphinx
- Technical documentation that just works
-
Furo – A clean customizable documentation theme for Sphinx
This theme was created by one of the maintainers of pip, which is where I first saw it (https://pip.pypa.io/en/stable/). Here are some of the things I like about it:
- Well-chosen, proportionate font sizes and spacing.
- Table of contents sidebars for both the current page and the whole documentation site.
- Fully responsive: sidebars disappear in narrow windows or small screens, but can still be popped out.
- Clean color scheme with good contrast, and full support for dark mode (see screenshot at https://github.com/pradyunsg/furo/blob/main/README.md).
What are some alternatives?
Discord_Theme - 🎨 A discord theme that changes your CSS style
mkdocs-material - Documentation that simply works
simple.css - Simple.css is a CSS template that allows you to make a good looking website really quickly.
sphinx - The Sphinx documentation generator
nord - An arctic, north-bluish color palette.
mkdocstrings - :blue_book: Automatic documentation from sources, for MkDocs.
awesome-css-frameworks - List of awesome CSS frameworks in 2024
vscode-theme-alabaster-dark - Dark version of alabaster ported from https://github.com/tonsky/sublime-scheme-alabaster
pollen - The CSS variables build system
fastapi - FastAPI framework, high performance, easy to learn, fast to code, ready for production
astro - The web framework for content-driven websites. ⭐️ Star to support our work!
PVEDiscordDark - A Discord-like dark theme for the Proxmox Web UI.