anotherkamila/kamila.is

my personal website

kamila.is source

Builds with Jekyll (using the github-pages gem).

License

The content is licensed under CC-BY-4.0 (as indicated by the LICENSE file).

The code is dual-licensed under CC-BY-4.0 and MIT (because licensing code under CC is weird ¯_(ツ)_/¯).

kamila.is's Issues

Use MDL cards for contents instead of lists, where it makes sense

Make the page headings prettier

Change kamila.is/talking layout to use cards and be pretty and stuff

• split by topics in an accordion-like way
• have cards that looks kinda like the first slide of my presentations
• kill the github link to the separate /talks repo, it doesn't work now that I have Jekyll templates instead of plain HTML

Fix the CSS of the header nav

Requirements for a "fix this website already" thing

Content

• Have a useful menu, with links to the subfolders (such as teaching/ , talking/, etc.). Only the canonical URLs for items with multiple URLs should be listed. Both autogenerating it and setting it manually are okay.
• Make the header link work :D
• Fill the homepage with a human-friendly site map: links to important things and one-line descriptions

Style

• Um actually. I think I just want a combination of these things from https://getmdl.io/templates/index.html:
  • color scheme probably solarized or something
  • menu layout like "ANDROID.COM MDL SKIN" / "TEXT-HEAVY WEBPAGE", just light on dark
  • typography possibly like "STAND-ALONE ARTICLE", and maybe with "cards" like "TEXT-HEAVY WEBPAGE" for stuff like my favourite "Note:"

I am leaving the below requirements here anyway, for reference.

---

• Make the menu look good (probably by having a dark header menu bar -- #002b36? :-) ), and make it mobile-friendly. Ideally Material Design (I want simple and I don't like Bootstrap).
• Actually, probably just base the thing on https://getmdl.io/ (and remove the half-broken old Bootstrap crap).
• Have a consistent design for the whole site: consistent colors, fonts, and spacing. Optimise for legibility: search for what's best for on-screen long form content.
  Some obvious things:
  • Max width for content: Lines should not be longer than 60 characters.
  • Search for the optimal font size, line height, paragraph spacing, heading sizes and heading spacing. Don't reinvent the wheel, typographers know better. There should be re-usable CSS for such stuff.
  • Font: I like Lato, Roboto is also decent. Googling for the above might also provide font suggestions.
  • Code font: I am told Input Sans. I suppose... 🤷‍♀️
• Maybe: Re-color my CV (again)? I think it's supposed to be green today :D

---

This is an all-encompassing issue. It's a superset of issues #4, #3, and #2, and closing this will close them.

Actually add index pages with links to things :D

[teaching/how-routers-work] Clarify what you mean by "port"

For those who might be coming at this document mostly thinking in terms of TCP/IP I'd suggest clarifying at the beginning that when you use the term "port" you are referring to a physical connector on the switch, not a port like port 80.

[teaching/shell] split into its own repo

In order to make teaching/shell (my shell tutorial) more accessible to contributors, it should be split out into its own repository that builds with minimal dependencies (i.e. just plain jekyll). Then it should be included here as a submodule (bleeergh I hate submodules).

For each menu item: fix up the index page + canonical_url mess

Make it contain its canonical_url, or maybe derive it automatically if not present. Perhaps also generate the menu instead of hard-coding it.

Make long-form text prettier

Search for the optimal font size, line height, paragraph spacing, heading sizes and heading spacing.

Use some stuff to separate h1 things... maybe horizontal lines like in my CV?

[teaching] Use CSS classes for things like "Note: " and render it prettily

I now have MDL cards and stuff. Perhaps I should use them.

Add pretty CSS for an "Alternative" note and use it on /learning/building-my-home-router

probably should have a "fork in the road" icon thingy

get rid of kamila.is/learning and replace with something like kamila.is/thinking or what, I don't know

Get pretty CSS for long-form technical texts (such as those under /teaching)

and possibly use that instead of bootstrap, in case bootstrap isn't worth it

[teaching] Add a bit of JS for footnote backlinks

"degrades gracefully" :D

[teaching] Generate a TOC for long pages

Somehow :D