the flattening
not to be confused with the Minecraft technical update I'm moving about the pages to be have a more flat, less nested structure. I feel like that'll improve URLs a lot, making them more readable than ever. over the years I've learned that flatter is better, and that tagging is generally a much more effective way of organising things. this doesn't get rid of categories entirely, as I think having the category makes the URL much a bit more readable in the end. my current vision does include a concept of "major categories" either way.
This commit is contained in:
parent
20e29e3b2c
commit
39a6155bdc
33 changed files with 63 additions and 120 deletions
405
content/programming/about-treehouse.tree
Normal file
405
content/programming/about-treehouse.tree
Normal file
|
|
@ -0,0 +1,405 @@
|
|||
%% title = "about the treehouse"
|
||||
|
||||
% id = "01H89RFHCQCD3E1XS5XAPW86J5"
|
||||
- liquidex's treehouse can be thought of as many things.
|
||||
|
||||
% id = "01H89RFHCQQMBNFETGPY4HHDT6"
|
||||
+ ### the treehouse is a reflection of my own personality
|
||||
|
||||
% id = "01H89RFHCQ4XHDXK0FH376SNZ8"
|
||||
- this is a literal braindump
|
||||
|
||||
% id = "01H89RFHCQEQ2RAWRTRN6HZ8A3"
|
||||
- whatever's on my mind at the time that I wanna share with the world, I write down here
|
||||
|
||||
% id = "01H8W7VEVGGS29756T8C466GRY"
|
||||
- doing my best to keep it approachable and readable by not just me, but _you_ too
|
||||
|
||||
% id = "01H89RFHCQY5EE9Y46PHJT9DFR"
|
||||
- I built this treehouse because I love sharing cool stuff with people
|
||||
|
||||
% id = "01H89RFHCQR0H2CRNA81XAGXWJ"
|
||||
- and also because I am obsessed with many things and I wanna share this obsession with the world
|
||||
|
||||
% id = "01H89RFHCQDC73N0MD2ZF629MF"
|
||||
- wouldn't you make yourself at home?
|
||||
|
||||
% id = "01H8VWEFHZA94G0DNPD79YV535"
|
||||
+ …
|
||||
|
||||
% content.link = "treehouse/emoji"
|
||||
id = "01H8VWEFHZ7Z71WJ347WFMC9YT"
|
||||
+ by the way did you know this website has custom emojis? and quite a lot of them, too
|
||||
|
||||
% id = "01H89RFHCQKAPHSGCDN832QRMD"
|
||||
+ ### the treehouse is a statement of artistic expression
|
||||
|
||||
% id = "01H89RFHCQAD7WKW59CAFAX814"
|
||||
- the treehouse is not your typical blog
|
||||
|
||||
% id = "01H89RFHCQKJPNXX7QKWM9X8GM"
|
||||
- as you can tell the structure is quite different
|
||||
|
||||
% id = "01H89RFHCQJNJSTJCTXSDCVF6C"
|
||||
- instead of containing finished posts, it just sort of… is
|
||||
|
||||
% id = "01H89RFHCQHWWE24N1NF1N2V85"
|
||||
+ nesting indefinitely
|
||||
|
||||
% id = "01H89RFHCQNX4PP80E49AWWQPM"
|
||||
+ like really, where does it end?
|
||||
|
||||
% id = "01H89RFHCQCCWWMZCXEXF704Q3"
|
||||
+ _where?_
|
||||
|
||||
% id = "01H89RFHCQW4NN6PW6V6RFCVH3"
|
||||
content.link = "the-end-is-never"
|
||||
+ _*WHERE???*_
|
||||
|
||||
% id = "01H89RFHCQPAMNSN81SRVH2TZ5"
|
||||
- always evolving and shaping and shifting
|
||||
|
||||
% id = "01H89RFHCQEJZQFXKVVQ92816R"
|
||||
- so that I never need to _finish_ anything
|
||||
|
||||
% id = "01H89RFHCQ3Q6W2Q0QKRHRVFVW"
|
||||
- I can just sit down, type something out
|
||||
|
||||
% id = "01H89RFHCQCTZFY3RV0J5MPMW9"
|
||||
- then forget about it
|
||||
|
||||
% id = "01H89RFHCQ3J04CRY0RAVN8YG5"
|
||||
- then come back again, type out something more
|
||||
|
||||
% id = "01H89RFHCQYK8R7SG5SNH5JNC8"
|
||||
- isn't this just way more pleasant?
|
||||
|
||||
% id = "01H89RFHCQ4F0AWTGVWVQXFFGK"
|
||||
- isn't that… in the spirit of [Agile](https://en.wikipedia.org/wiki/Agile_software_development)
|
||||
|
||||
% id = "01H89RFHCQHS0R71CP198SRX16"
|
||||
- …of all things?
|
||||
|
||||
% id = "01H89RFHCQYH846FGW8Z8EFX2E"
|
||||
- not that I designed around its ideas, but there's a semblance, isn't there?
|
||||
|
||||
% id = "01H89RFHCQQK8Q1WHZK4ZK1EK1"
|
||||
+ it is designed to be elegant and clutter-free
|
||||
|
||||
% id = "01H89RFHCQ4N6GMFF0Q2N4PCM6"
|
||||
- the treehouse contains no ads to annoy you, no [sidebars][page:design/sidebars] to interrupt
|
||||
|
||||
% id = "01H89RFHCQDMWX7WNSMBDWJC9G"
|
||||
- it doesn't even have a navigation bar, because it doesn't need one
|
||||
|
||||
% id = "01H89RFHCQ9WEBCQMQH7PSQDFS"
|
||||
- it's built to focus on the substance
|
||||
|
||||
% id = "01H89RFHCQ9PVANQV8YNKBY399"
|
||||
- it's built to let your imagination go free
|
||||
|
||||
% id = "01H89RFHCQR2R4XX7CRX8HZRAF"
|
||||
- it's just a cool space to let go of your worries, and breathe
|
||||
|
||||
% id = "01H89RFHCQ6WVDR3CWVY99F87M"
|
||||
+ it is designed to be user-friendly
|
||||
|
||||
% id = "01H89RFHCQBDVZX9Y7JTSGRV5G"
|
||||
- because there is too much software nowadays that does not care about _you_
|
||||
|
||||
% id = "01H89RFHCQEFERYSZ77ZD2DS0M"
|
||||
- and that frustrates me, too
|
||||
|
||||
% id = "01H89RFHCQ3EAP0F6PRSEK7S1T"
|
||||
- there are bits of JavaScript that power this site, to make it just that little bit more pleasant
|
||||
|
||||
% id = "01H89RFHCQGF3R8FAP0QHYB6WM"
|
||||
- but without overwhelming your computer or bandwidth
|
||||
|
||||
% id = "01H89RFHCQ1XA3BB3BTKXH36CX"
|
||||
- you can disable the JavaScript, and everything will mostly work
|
||||
|
||||
% id = "01H89RFHCQS2WW7PBP1YV0BEJZ"
|
||||
- but you may not find the experience favorable
|
||||
|
||||
% id = "01H89RFHCQ7HTZSP6P2RZR8JHE"
|
||||
+ but most important of all, it is _weird_.
|
||||
|
||||
% id = "01H89RFHCQTRVPZ0AJ0DGJHXKX"
|
||||
- weird as me
|
||||
|
||||
% id = "01H89RFHCQ3D3Z82YGJRNV8ASR"
|
||||
- writing this "poem"
|
||||
|
||||
% id = "01H89RFHCQXB6F45KN28P91YCK"
|
||||
+ can you even call it that?
|
||||
|
||||
% id = "01H89RFHCQ48R7BCZV8JWPVFCY"
|
||||
+ have I invented something new here?
|
||||
|
||||
% id = "01H8VWEFJ1BGA21FBVHC4TFF3V"
|
||||
- the "Choose Your Own Poem" lol
|
||||
|
||||
% id = "01H8W7VEVHCAEM03Z75QYC36SG"
|
||||
- I understand if this form of writing can be daunting at first, but please, give it a shot. I'm doing my best to make it as accessible as possible.
|
||||
|
||||
% id = "01H89RFHCQAXJ0ST31TP1A104V"
|
||||
+ ### the treehouse is a mostly statically generated website
|
||||
|
||||
% id = "01H89RFHCQ2GWJPTAKTRGS1QAC"
|
||||
+ weird poems and philosophical talk are over, it's time to focus on the tech.
|
||||
|
||||
% id = "01H8V55APDEF8WTQ3KFC7E9HWB"
|
||||
- call this an overview, Defense of Design, or what have you
|
||||
|
||||
% id = "01H89RFHCQF4N9T05B9DVWX67K"
|
||||
- treehouse is built in the programming language that gives me the most pleasure coding.
|
||||
|
||||
% id = "01H8V55APDXH5N1YC2WXDBCDN4"
|
||||
- no need for you to know more. :shhh:
|
||||
|
||||
% id = "01H89RFHCQAQVXP6B2H0T8NNDS"
|
||||
- personally… the language you build a personal project with almost never matters. it's rather how you execute your ideas.
|
||||
|
||||
% id = "01H8V55APDRZHHG69A6BWQM8YE"
|
||||
+ therefore I find boasting that my project is powered by a `$LANGUAGE` or a `$FRAMEWORK` unnecessary.
|
||||
|
||||
% id = "01H8V55APDNJ4W3MY1A204PHJ3"
|
||||
+ but if you really care that much, it's built with Rust, plain HTML5, plain CSS, and
|
||||
[Vanilla JS](http://vanilla-js.com/).
|
||||
|
||||
% id = "01H8V55APDYHZG2QXQ78HZE97V"
|
||||
- (yes, I know that website is super old, but I still find it incredibly funny :hueh:)
|
||||
|
||||
% id = "01H89RFHCQRA4BBBWDC8K68BB0"
|
||||
- if you wanna browse the source code, feel free to [check it out here][def:treehouse/repo]
|
||||
|
||||
% id = "01H89RFHCQFWC2FWBAE9PVNC08"
|
||||
- as I alluded to [here][branch:01H89RFHCQ3EAP0F6PRSEK7S1T], treehouse is built to decay gracefully
|
||||
as you take away the fancy parts.
|
||||
|
||||
% id = "01H8V55APDMPF3WFTNTFSYBQRF"
|
||||
+ you will be able to read it just fine without JavaScript, just that it'll be a little
|
||||
less pleasant.
|
||||
|
||||
% id = "01H8V55APD1RSSRMDZ3CEE9S9C"
|
||||
- that's because the JS handles stuff like lazy loading of linked trees.
|
||||
|
||||
% id = "01H8V55APDAPSR7R9M569GW4S7"
|
||||
- you may have seen a brief _"Loading…"_ text flash before your eyes as you opened this
|
||||
_about this_ branch - that's it downloading another tree and pasting it into this document
|
||||
|
||||
% id = "01H8V55APDS9BNC2TQ5S5VYC0G"
|
||||
- when JS is unavailable we fall back to a plain old `<a>` link through a
|
||||
`<noscript>` tag. if you have uBlock Origin, or any other JS blocker, you can try
|
||||
that out yourself!
|
||||
|
||||
% id = "01H8V55APD503DMXJD9JA2WJGS"
|
||||
- the JS also lets you select text in these `<details>` elements without them collapsing
|
||||
as you release the mouse button.
|
||||
|
||||
% id = "01H8V55APD34KE6ED6MRTW34H6"
|
||||
- I have no clue why it is this way by default, but frankly it's like a 5 line
|
||||
usability fix, so why not.
|
||||
|
||||
% id = "01H8V55APDR3VCEANQ6XVJP3X8"
|
||||
- if you have accessibility concerns about this decision, please let me know.
|
||||
|
||||
% id = "01H8V55APDFW5SPAKSQ04K5HRE"
|
||||
- it also saves your progress as you read. if you refresh the page, you'll notice you end up exactly where you left off!
|
||||
|
||||
% id = "01H8V55APDNSXZMZJ2K1KW11KN"
|
||||
- but, there is one very crucial piece of JavaScript that makes this website tick, and your experience *will be degraded* if you disable it. that feature is linking to branches.
|
||||
|
||||
% id = "01H8V55APDBG6AH2W3RNMX724X"
|
||||
- by default, if you link to an element by its id and it's contained within a `<details>`, the `<details>` will not expand. :ralsei_dead:
|
||||
|
||||
% id = "01H8V55APDE0KSKKAS8RBRPYRM"
|
||||
- therefore there's a bit of JS to make that work, _and_ to tie that together with lazy loading.
|
||||
|
||||
% id = "01H8V55APDTZSSYTY17SYZ6DGQ"
|
||||
- treehouse will not work *as* fine without CSS though - the `<details>` will look extremely
|
||||
janky, but the content should still be fully readable.
|
||||
|
||||
% id = "01H8V55APDWN8TV31K4SXBTTWB"
|
||||
+ myself, I'm writing this content in a bespoke format called `.tree`.
|
||||
|
||||
% id = "01H8V55APDGX4EYV8W7ECXZ6FP"
|
||||
- the structure of `.tree` files is extremely minimal. there are only a few syntactic features to speak of.
|
||||
|
||||
% id = "01H8V55APDR95HSV0TX7TK63AF"
|
||||
- here's a taste of `.tree`:
|
||||
|
||||
% id = "01H8V55APD5686J8GTXP118V8E"
|
||||
- ```treehouse
|
||||
% id = "root"
|
||||
- this is a branch
|
||||
|
||||
% id = "child"
|
||||
- this is a child branch
|
||||
|
||||
+ this is a branch that is collapsed
|
||||
|
||||
- and this is a child of that branch
|
||||
|
||||
% content.link = "some-other-tree"
|
||||
- and this branch links to another tree
|
||||
```
|
||||
|
||||
% id = "01H8V55APDB49SPHPPMV2BCMW3"
|
||||
- the `.tree` format is line-based. that means the `%`, `-`, and `+` tokens are only
|
||||
interpreted when at the beginning of a line.
|
||||
|
||||
% id = "01H8V55APD67W8FHEZK6E2A21K"
|
||||
- the basic unit of `.tree` is a branch. branches…
|
||||
|
||||
% id = "01H8V55APDQ1KS7S313GK590GM"
|
||||
- …are located at a specific _indent level_
|
||||
|
||||
% id = "01H8V55APDHNRFCGH9STD46J0F"
|
||||
- …may or may not have _attributes_ - that's what the percentage sign `%` begins
|
||||
|
||||
% id = "01H8V55APDF9C7Y0QDYF3EBMMS"
|
||||
- …may or may not be expanded by default (this is the branch's _kind_) - that's what the minus `-` and plus `+` tokens do
|
||||
|
||||
% id = "01H8V55APDJ6EYE4PR370JAT4W"
|
||||
- each branch is constructed in this order: optional attributes, kind, content
|
||||
|
||||
% id = "01H8V55APDGT47G5DKZKTQ1S80"
|
||||
- and ends when another line beginning with `%`, `-`, or `+` is found.
|
||||
|
||||
% id = "01H8V55APDQ3VYBBTTMNFTVNV4"
|
||||
- other than that, `.tree` assumes nothing about what format the branch attributes or content are encoded in.
|
||||
|
||||
% id = "01H8V55APDCXPW8JPRYZHY9NXV"
|
||||
- I chose TOML and [Djot](https://djot.net) for their ease of use and flexibility, but the parser couldn't care less.
|
||||
|
||||
% id = "01H8V55APDWDPSHNZX6QJFM8ZA"
|
||||
- …actually, that's a lie. see that code example above? Markdown code fences \`\`\` are handled specially to let embed `.tree` source code blocks within `.tree` files. that's all.
|
||||
|
||||
% id = "01J3GNWRFBPK8VSRV1J61Q2V8F"
|
||||
- I actually used to use Markdown, but then I saw Djot and progressively warmed up to it until I convinced myself fully that "yes, this is a better markup format."
|
||||
|
||||
% id = "01H8V55APDVQB6AD23Y6PZPPB8"
|
||||
- every branch in the treehouse has a globally unique ID.
|
||||
|
||||
% id = "01H8V55APD4H5JT8NTYCCTN77G"
|
||||
+ this is because I want every branch to be individually linkable and quotable.
|
||||
|
||||
% id = "01H8V55APDPSZNP9AK7QRK62BG"
|
||||
- if you ever want to link anything I said in an argument online: hover over a branch, right-click that little _permalink_ icon that's on the right side of the screen, and _Copy Link_.
|
||||
|
||||
% id = "01H8V55APDCZ0HY20GGXYE8D1G"
|
||||
- but manually coming up with ids for branches would be quite the nuisance.
|
||||
|
||||
% id = "01H8V55APDXV0KRVEF9PTA72J7"
|
||||
+ that's why with the power of Tools Programming™, I built a tool that fills out all the ids for me.
|
||||
|
||||
% id = "01H8V55APD8VG7WE6JX5JBDJEC"
|
||||
- I chose [ulids](https://github.com/ulid/spec) for generated ids, for a few reasons:
|
||||
|
||||
% id = "01H8V55APD2J58ENT1T0JRJ7H6"
|
||||
- they're guaranteed to be unique, so I can be sure no two branches end up having the same id
|
||||
|
||||
% id = "01H8V55APDGV6PKJKZ16CJ1YXY"
|
||||
- which is precisely what lets me pull the trick where I embed one tree within another, and you just dig into `index.html`.
|
||||
|
||||
% id = "01H8V55APD1CYZD8GE3AK87QK2"
|
||||
- they embed a timestamp, which I can use to display the date/time when a branch was written, because I generally `fix` branches right after writing
|
||||
|
||||
% id = "01H8V55APDFXW5A5J85HJQP17C"
|
||||
- as well as highlight branches which were added since your last visit
|
||||
|
||||
% id = "01H8V55APDPZK4C8H5TTHTHH7J"
|
||||
- not that either of these features are implemented as of writing this
|
||||
|
||||
% id = "01J3GNWRFBK2W3X8BZHD2AXQXZ"
|
||||
- actually they're implemented now so yeah
|
||||
|
||||
% id = "01H8V55APDXB9AXTAGAE9TNQRB"
|
||||
- they're much more compact than [uuids](https://en.wikipedia.org/wiki/Uuid)
|
||||
|
||||
% id = "01H8V55APDZE5AE92GDM2TH2EF"
|
||||
- which use 32 hexadecimal digits separated unevenly by 4 dashes, giving you 36 characters.
|
||||
|
||||
% id = "01H8V55APDS478E3ED5CRVT6RE"
|
||||
- who even remembers how many digits there are between each dash? I know I don't.
|
||||
|
||||
% id = "01H8V55APDXP1D0MHGN2DXBT16"
|
||||
- ulids on the other hand are 26 digits encoded with [Crockford's base32](https://www.crockford.com/base32.html)
|
||||
|
||||
% id = "01H8V55APD79QTC2NFC6X7S3W4"
|
||||
- which is cool because it's much denser while avoiding ambiguous characters - `0`, `O`, and `o` are all interpreted as `0` (zero).
|
||||
|
||||
% id = "01H8V55APDXT064G9PA78JW0CM"
|
||||
+ noticed how fast the treehouse restores your state? there's basically no delay.
|
||||
|
||||
% id = "01H8V55APDGS626M5Y6DDAS9ZE"
|
||||
+ this is because it restores your state _as it's loading in_, by using a [`MutationObserver`](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver).
|
||||
|
||||
% id = "01J09E55GTGHTGJP3JQN1SY4BM"
|
||||
- initially the treehouse used Web Components, but for Webkit compatibility reasons, I had to switch that out to a more bespoke solution.
|
||||
|
||||
% redirect_here = ["01H8V55APD4V54M2EKQKQ4GNP8"]
|
||||
id = "01J09E55GTFSQW46JSG3T3SSMQ"
|
||||
- elements such as linked branches are implemented using _spells_, which are a custom framework for composing behaviors on top of existing elements.
|
||||
|
||||
% id = "01J09E55GTHJXWRG0P9MADASRQ"
|
||||
+ in addition to that, many things on the treehouse are Web Components, which are another awesome API that lets you prepare the DOM as soon as everything is ready.
|
||||
|
||||
% id = "01H8V55APD73AG65NP2VGX6169"
|
||||
- despite many people calling that API extremely low-level, I beg to differ. it's actually pretty easy and pleasant to use.
|
||||
|
||||
% id = "01H8V55APDDHYNRZXQDEG0A242"
|
||||
- most importantly it lets me enhance vanilla `<li>` elements with custom behavior executed on load, which I use to restore your reading progress as the page is loading in.
|
||||
|
||||
% id = "01H8V55APDKY0HYEJM2C1CJHEG"
|
||||
+ while not strictly a technical topic, I'd like to shout out [Recursive](https://recursive.design) for being an awesome font :ralsei_love:
|
||||
|
||||
% id = "01H8V55APD88JCQBQ4SHVCYR97"
|
||||
- (not to be confused with [Font Awesome](https://fontawesome.com/), which I do not use here. icon designs are my own.)
|
||||
|
||||
% id = "01H8V55APD0S00ACN0YY7Y9MSW"
|
||||
+ being a variable font, I can tweak the text's look and feel on many different axes.
|
||||
|
||||
% id = "01H8V55APDRG88JRV74MMDTV4J"
|
||||
+ the one that I wanted to shout out in particular is `CASL`, which lets me make it look a lot more happy and playful.
|
||||
|
||||
% id = "01H8V55APDMP5FE9ZCMRACH18W"
|
||||
+ almost like Comic Sans, but without all the stigma.
|
||||
|
||||
% id = "01H8V55APDPGMD33J4M3SJ2QKP"
|
||||
- I actually considered using [Comic Neue](https://comicneue.com/) as the font on this website, but ultimately chose Recursive.
|
||||
|
||||
% id = "01H8V55APDXBS7HMDSCEJ1JDPY"
|
||||
- Comic Neue and not the Real™ Comic Sans MS because it's licensed under the SIL Open Font License, which means I could redistribute it on my website.
|
||||
|
||||
% id = "01H8V55APDFT0Y4ECEM92XFTTR"
|
||||
- not everyone runs Windows or macOS, so just assuming the reader has Comic Sans installed isn't ideal.
|
||||
|
||||
% id = "01H8V55APD2BPGQXEK7JARYJ9H"
|
||||
+ {-in particular the variant on my website is 100% casual (`CASL`), and -2.0 slanted (`slnt`).-}
|
||||
|
||||
% id = "01H8V55APDXZJE3HHH5AQ8ZQHF"
|
||||
+ that little bit of slant makes it look just a little more like handwriting.
|
||||
|
||||
% id = "01H8V55APDGSB2Y742S07DHTAZ"
|
||||
- I actually thought of handwriting all the text in the treehouse, but ultimately thought it would be too much work. and a technical challenge too.
|
||||
|
||||
% id = "01H8V55APDDXH02F91RM19RDHX"
|
||||
- how to make it scalable (as in, how to keep it smooth when you zoom in?)
|
||||
|
||||
% id = "01H8V55APDQ1N44QASCHVDB4D5"
|
||||
- how to make it scalable (as in, my hand really fucking hurts from writing this much, and I *really* do not wanna go back to the times of writing school essays please?)
|
||||
|
||||
% id = "01H8V55APDP5T3EYPVMVN9QVK7"
|
||||
- how to make it scalable (as in, how to distribute this many images to the user without tanking their internet connection?)
|
||||
|
||||
% id = "01H8V55APDB8PC2BF5P9TVYJ35"
|
||||
- not to mention I'd have to handwrite a lot of text, and *then* either use OCR or type it all out again for accessibility. yeah, no thanks methinks.
|
||||
|
||||
% id = "01HRD97CSJSQN78SGM691B6PNQ"
|
||||
- NOTE: not slanted anymore. `slnt` is 0.
|
||||
|
||||
% id = "01JCGYHVMWWKKZ1532WC32DXNW"
|
||||
- _NOTE: this page is quite old, so I moved it from the main page to the programming blog to reduce clutter. I deemed it wasn't important enough to have it on display so profoundly._
|
||||
|
|
@ -1,88 +0,0 @@
|
|||
%% title = "derive me some Nix"
|
||||
|
||||
% id = "01J31356Q1A4Z54F3G7THB1C81"
|
||||
- chances are you've heard about Nix or NixOS from somewhere and would like to learn more about it.
|
||||
|
||||
% id = "01J31356Q1AQE7ZBE2P7FG03G4"
|
||||
- if that is the case, welcome to the club!
|
||||
we're pretty much in the same bucket.
|
||||
I literally just started using Nix a couple days ago, and I found the documentation *really* unclear.
|
||||
so here's my shot at a more pedagogical approach.
|
||||
|
||||
% id = "01J31356Q1N80MYK77MP3BMJ1E"
|
||||
- if that's not the case - Nix is a package manager and system configuration language.
|
||||
basically, you specify how you want your system to look using config files stored in one place, and Nix _derives_ the system from that config file for you!
|
||||
|
||||
% id = "01J31356Q13VHG7EN0Q24A6GSM"
|
||||
- I emphasized the word _derives_, because _derivation_ is the fundamental operation of Nix the package manager.
|
||||
your entire config is specified declaratively, and the entire folder structure and all configuration files are _derived_ from that config.
|
||||
but we'll get to that shortly.
|
||||
|
||||
% id = "01J31356Q1G1X5X9Q7BPDT41R5"
|
||||
- people seem to be excited about Nix for many reasons.
|
||||
I'm excited because it helps me achieve *online independence.*
|
||||
|
||||
% id = "01J31356Q12T9Z1WE300PD7J79"
|
||||
- did you know that since last weekend (since this was written) this website runs on NixOS?
|
||||
|
||||
% id = "01J31356Q1KM0TT28D4PHZTAR9"
|
||||
- being able to take your VPS's configuration elsewhere and let Nix cook your system up automatically is extremely cool.
|
||||
it's something that's always frustrated me with how Linux software is configured -
|
||||
lots of little configuration files scattered across `/etc` and sometimes other directories, which ends up being extremely hard to replicate if you ever want to switch server providers.
|
||||
|
||||
% id = "01J31356Q1D0SJPJB1V4MYPNX9"
|
||||
- *and* your system config will end up identical to the one you had before!
|
||||
isn't that awesome?
|
||||
|
||||
% id = "01J31356Q1BNSAF75KDE4PN2PJ"
|
||||
- word of warning though: I wouldn't recommend running NixOS on a home PC.
|
||||
|
||||
% id = "01J31356Q1C13GSD9KSXETWW1B"
|
||||
- I use :btw: on my home PC for a very simple reason.
|
||||
it's just _really darn simple_ to change anything about my system.
|
||||
|
||||
% id = "01J31356Q1JZ13FY2XAVVKAN97"
|
||||
- need to install a new package? `pacman -S`.
|
||||
|
||||
% id = "01J31356Q1VJ0HFQYVS1AE7CZB"
|
||||
- need to edit system config?
|
||||
well first of all no you don't, because other than fundamental config you change during installation, we both know Arch works pretty much works out of the box on your PC,
|
||||
but even if you _do_ end up needing to change some config for a workaround, it's generally only because you need a _workaround_ - which may not be needed by the time you reinstall your system.
|
||||
|
||||
% id = "01J31356Q162ACZG4S6M9YNQX2"
|
||||
- and reinstall your OS pretty rarely.
|
||||
|
||||
% id = "01J31356Q1ZXDA6QX5P978FTPS"
|
||||
- most of your _important_ configuration is stored in `$HOME` y'know, and that's easy to keep between reinstalls - you have a separate `/home` partition after all.
|
||||
|
||||
% id = "01J31356Q1KYMMG64D3TNXH3C5"
|
||||
- :btw: is also Really Darn Fast.
|
||||
I can't say that about NixOS.
|
||||
the package manager is excruciatingly slow to update your system config.
|
||||
the initial install took _really_ long for how barebones of a system I specified in my config.
|
||||
|
||||
% id = "01J31356Q1CA21R7GM9MXGQ7Q4"
|
||||
- let's derive us a system! as I mentioned before, everything in Nix is achieved by means of _derivations_.
|
||||
|
||||
% id = "01J31356Q191D3J645CT75YFEJ"
|
||||
- from a programming perspective, a derivation is simply a function `options -> path`, where `options` is an attribute set specifying how the output `path` should be derived.
|
||||
|
||||
% id = "01J31356Q1PRWPYD0EGGY1ZK3W"
|
||||
- and that's *it*.
|
||||
|
||||
% id = "01J31356Q1445NB18CNBE91CZP"
|
||||
- suppose you'd like to download a file from the Internet.
|
||||
that's what the `pkgs.fetchurl` function is for.
|
||||
|
||||
```nix
|
||||
# This expression results in a path to the downloaded file.
|
||||
pkgs.fetchurl {
|
||||
url = "https://liquidex.house";
|
||||
# As long as you fill in the hash, which I don't know...
|
||||
# Nix will tell you what it should be though!
|
||||
hash = "";
|
||||
}
|
||||
```
|
||||
|
||||
% id = "01J31356Q1HEW2HCTG27BDFJM2"
|
||||
- but where does `pkgs` even come from?
|
||||
|
|
@ -3,11 +3,11 @@
|
|||
% id = "01H9R1KJESR2F420HE67HW4AVR"
|
||||
- notes and design lessons from the best programming language of all time that everyone loves (not really)
|
||||
|
||||
% content.link = "programming/languages/cxx/access-modifiers-as-labels"
|
||||
% content.link = "programming/cxx/access-modifiers-as-labels"
|
||||
redirect_from = ["programming/cxx/access-modifiers-as-labels"]
|
||||
id = "01H9R1KJESGGM35KT8ANEA2B9Q"
|
||||
+ :page: access modifiers as labels (`private:`, `protected:`, and `public:`)
|
||||
|
||||
% content.link = "programming/languages/cxx/shared-unique-ptr-deleter"
|
||||
% content.link = "programming/cxx/shared-unique-ptr-deleter"
|
||||
id = "01J0VN48AZYH6KJGK7PSKN0PCA"
|
||||
+ :page: freeing C memory automatically using `std::unique_ptr` and `std::shared_ptr`
|
||||
|
|
@ -9,18 +9,18 @@
|
|||
% id = "01H8YGXP0ZWG6X3PB6GWSGKAT0"
|
||||
- both the fun and the good, and that which ruins my mood
|
||||
|
||||
% id = "programming/technologies/unreal-engine/blueprint"
|
||||
content.link = "programming/technologies/unreal-engine/blueprint"
|
||||
% id = "programming/unreal-engine/blueprint"
|
||||
content.link = "programming/unreal-engine/blueprint"
|
||||
+ :page: thoughts on Blueprint
|
||||
|
||||
% id = "01HP1FESY5WVJG4X80AZ4ZBX5D"
|
||||
- :folder: random but cool things
|
||||
|
||||
% content.link = "programming/technologies/unreal-engine/generated-body"
|
||||
% content.link = "programming/unreal-engine/generated-body"
|
||||
id = "01HV1DGFHP6GB268MDGGDXMR12"
|
||||
+ :page: how does `GENERATED_BODY()` work exactly?
|
||||
|
||||
% content.link = "programming/technologies/unreal-engine/fixes"
|
||||
% content.link = "programming/unreal-engine/fixes"
|
||||
id = "01HP1FESY5ZS6YTZXA8QTT5V1Z"
|
||||
+ :page: data validation quick fixes
|
||||
|
||||
Loading…
Add table
Add a link
Reference in a new issue