7 ms·
Artisanal handcrafted Git repositories
- sc68cal 1y agoTo the site author: I'm on a MBP M1 Mac and honestly I can't really read the text. Far too small, and increasing the zoom just makes the text large but the margins less wide. Firefox reader mode also renders really badly. Please, consider making the layout better for us old coders whose eyes are going, or for hi res displays
- sam_lowry_ 1y agoWorks great on Firefox for Android though )
- lucasoshiro 1y agoAlso works great on Safari on a M1 MacBook Air, here
- derefr 1y agoFYI: the pinch-to-zoom gesture from mobile browsers (from before websites were mobile-responsive) has also long been implemented for all modern desktop browsers. It's viewport zoom, which is far better than the font-scaling zoom you get by pressing Cmd-+, and makes this site easily readable. (The much-less-well-known mobile double-tap-on-text gesture [it zooms-to-fit whatever element you tapped on to the width of the viewport] was also ported to desktop browsers. Though, on desktop with a touchpad, it's a two-finger double-tap — which I don't think anyone would ever even think to try.)
- BobaFloutist 1y agoDouble tap on text highlights it for me. Is that an Iphone/android thing or what?
- derefr 1y agoAs I said, it's a two finger double-tap. But also, under further investigation — and unlike with pinch-to-zoom — desktop support for the two-finger double-tap gesture seems to be specific to macOS. (Which is weird, because Chrome has support for arbitrary multitouch gesture processing to enable the JS multitouch API. So you'd think Chrome's support for "the multitouch gestures the OS expects" would be built on top of that generic multitouch recognizer [and therefore working everywhere that recognizer works], instead of expecting the OS to pre-recognize specific gestures and translate them to specific OS input events.)
- BobaFloutist 1y agoI was trying on my phone, but my laptop seems to interpret it as a right click. Which, frankly, makes sense.
- antonvs 1y agoOn my iPad in Safari and Pixel Android phone in Firefox, one-finger double tap on text does the fit to viewport. On my Ubuntu laptop in Chrome, I couldn’t find a way to make it work - even tapping the touchscreen didn’t work. But I’m not using the stock Ubuntu GUI, so it could be that (LXqt+XMonad).
- BobaFloutist 1y ago>Pixel Android phone in Firefox, one-finger double tap on text does the fit to viewport. I'm very confused, can you clarify what makes this different from the gesture that highlights text? Edit: it appears that "request desktop site" makes it fit the viewport, whereas using the mobile view it's I guess already fitting the viewport so it highlights the text. The strange thing is in the desktop view, if I pinch zoom after fitting the viewport and do it again, it zooms out, whereas the mobile view still highlights the text. Which kinda makes sense, since mobile view it's fairly likely that you zoomed in to highlight the text more accurately, though it's weird that it's so inconsistent.
- 1y ago
- LocalPCGuy 1y agoFWIW, most browsers by default now do a viewport zoom with Ctrl/Cmd-+ rather than a font-scaling zoom. I think browsers generally have the option to change that, so if you prefer the former but it's doing the latter, may check the browser settings.
- retsibsi 1y agoFor me, the text size would be fine if the contrast were better. The background colour is similar to the colour of the non-central pixels of the text, and even the central pixels are grey rather than black.
- drewsberry 1y agoThanks for letting me know. I'm on an M3 and haven't experienced any issues myself, but allowing for font size configuration seems like a pretty good idea. I'd added this in so if you happen to take another look, I'd be interested to hear whether you think this is an improvement.
- deadbabe 1y ago[flagged]
- ChrisMarshallNY 1y agoMy understanding is that Mercurial is sort of Beta to Git's VHS. There are some definite advantages, but it's losing support.
- GuB-42 1y agoI am sure that it is because the porn industry settled on Git :) Anyways, I started on Mercurial, and I think it has a better UX, but technically I now prefer Git. The success of Mercurial over Git surprised me a little because of that, Git is not an easy version control system to get into, at least when compared to Mercurial, it shouldn't help adoption, but I guess it is just because some big names decided on Git. Mercurial and Git use the same fundamental principles, and one is not really better than the other, just details.
- deleted 1y ago[deleted]
- zanecodes 1y agoI thought all the cool kids were on Pijul, or was it Darcs? Maybe it was Fossil? No wait, it was definitely Jujutsu.
- jact 1y agoCan confirm that cool kids are definitely using Fossil
- MrStonedOne 1y ago[dead]
- lucasoshiro 1y agoSomething that I really like in Git is how its data structures are easy to understand and how transparent it is. It's possible to write your own "Git" compatible with existing Git directories only by reading how it works under the hood
- shivasaxena 1y agoI agree, but only in theory. Projects like gitoxide have been in development for years now.
- fiddlerwoaroof 1y agoI wrote a nearly complete implementation of git file format parsers in Common Lisp over like a month of evenings and weekends. I’m sure there are hard parts between where I am and a full git implementation but you can get quite a bit of utility out of a relatively small amount of effort.
- lucasoshiro 1y agoYeah, I wrote mine in Haskell. It's a good exercise for understanding how Git works
- MrJohz 1y agoIt's a case of Pareto. Parsing the git file format is relatively simple, but handling all the weird states a Git repo can be in and doing the correct things to those files in each state is a lot harder. And then adding the network protocol on top of that makes directly reproducing Git quite difficult. I know JJ used to use Git2 for a lot of network operations like pushing and pulling, but ran into too many issues with SSH handling that they've since switched to directly invoking the Git binary for those operations.
- fiddlerwoaroof 1y agoThere aren’t that many weird states a git repository can be in: the on-disk format of the repository is too simple for that. The hard part has to do with the various protocols for transferring objects around.
- lysace 1y agoI would have called this: "Futzing around with internal git data structures".
- kassah 1y agoThe simplicity of Git is awesome. Great article! I had looked at what it would take to find a single file in a remote git repo. I decided against talking the git protocol directly and just checking out the entire repo to get a single file. Reading through this makes me think I may have given up too easily. I asked a few git hosting providers, and they all said they had private APIs developed internally for the purpose.
- gerdesj 1y agoThis is all very well but how does Linus Thorvalds use git? Given he invented the bloody thing, it might be nice to see how the Boss uses it! git was created to scratch an itch (actually a bit of a roiling boil, that needed a serious amount of soothing ointment and as it turns out: a compiler, some source code and quite a lot of effort). ... anyway the history of it is well documented. FFS: git was called git because a Finnish bloke with English as a second, but well used, tongue had learned what a "git" is and it seemed appropriate. Bear in mind that Mr T was deeply in his shouty phase at that point in time. Artisanal git sounds all kinds of wrong 8) Its just a tool to do a job and I suggest you use it in the same way as the XKCD comic mandates (that is the official manual, despite what you might think) The Conclusion is spot on - great article.
- veganjay 1y agoNeat to see this done by hand! It helps demystify the magic behind git commands. If you like this, I also recommend "Write Yourself a Git", where you build a minimal git implementation using python: https://wyag.thb.lt/ https://wyag.thb.lt/
- wonderwonder 1y agoHow cool, thank you
- bhasi 1y agoA similar project is CodeCrafters' Build Your Own Git: https://app.codecrafters.io/courses/git/overview https://app.codecrafters.io/courses/git/overview
- xqb64 1y agoThere is also James Coglan's "Building git" book that I just went through and can vouch for its quality.
- microtherion 1y agoSeconded, it was one of the most enjoyable tech books I've read in recent years.
- aeblyve 1y agoI thought this was going to be a sardonic article about doing programming without LLMs.
- lioeters 1y agoI'm starting to see this kind of wording as a unique selling point, that some software (or article, visual art, etc.) is handcrafted and artisanal, as opposed to AI-generated. "Every word was written by me, a human being!" At this point in the emerging technology I can usually tell the difference intuitively, but it's possible that one day it will be indistinguishable - and the quality of "handmade" will be simply a matter of branding for niche enthusiasts, like vinyl records.
- lan321 1y agoHomegrown bugs from sustainably raised Bio-certified devs vs industrial bugs.
- aeblyve 1y agoI honestly tend to think that products with "handmade" quality actually have worse quality. I'll usually chose software which is industrially produced and vetted versus some guy's weekend project.
- BobbyTables2 1y agoI realize the concept is very similar but would love to see a writeup on bow Docker stores images using OverlayFS. (Has quite a bit of metadata!)
- HexDecOctBin 1y agoOkay, there's something I have been thinking about recently. Is it possible to somehow make Git use the Content Defined Chunking algorithm from rsync? Maybe somehow using clean/smudge? If not git, then maybe Mercurial, Fossil or any other DVCS? This would help with large binary assets without having to deal with the mess that is LFS, as long as the assets were uncompressed.
- hanwenn 1y agoIIRC it already uses content defined chunking for finding object deltas.
- HexDecOctBin 1y agoNot really, which is why bup had to implement their own CDC instead of using Git's storage directly.
- bradfitz 1y agoMy recent horror from some git work was discovering how git sorts its tree objects. The docs just say to sort by C locale (byte-order sorting). Easy. Except git was sometimes rejecting my packfiles as being bogus per its fsck code, saying my trees were misordered. TURNS OUT THERE'S AN UNDOCUMENTED RULE: you need to append an implicit forward slash to directory tree entry names before you sort them. That forward slash is not encoded in the tree object, nor is the type of the entry. You just put the 20 byte SHA1 hash, which is to either a blob or a hash (or a commit for submodules). So you can have one directory with directory "testing" and file "testing.md" and it'll sort differently than a directory with two files "testing" and "testing.md". You can see a repro at https://gist.github.com/bradfitz/4751c58b07b57ff303cbfec3e39fca93 https://gist.github.com/bradfitz/4751c58b07b57ff303cbfec3e39... (So to verify whether a tree object is formatted correctly, you need to have the blobs of all the entries in the tree, at least one level)
- deleted 1y ago[deleted]
- Elucalidavah 1y ago> directory tree entry names But... git doesn't really store directories, does it?
- kaoD 1y agoI wrote a longer comment saying this (deleted now since I was wrong). Turns out that Git does somewhat store dirs (in form of trees). See https://git-scm.com/book/en/v2/Git-Internals-Git-Objects https://git-scm.com/book/en/v2/Git-Internals-Git-Objects (section "Tree Objects"). To understand op's repro look at the last two lines (objects in the tree) in each of their command outputs, not the files shown in the first few lines. What I think op means is that the `testing` tree pointed in their first example is sorted after `testing.md` even though it's only called `testing` because it's being sorted as `testing/` and `/` is > `.` bytewise. I'm not at a computer right now but it would be nice to test it with files named `testing.` and `testing0` since they are adjacent bytewise and would show the implicit forward slash more clearly with the tree object sitting between them. This makes me wonder why Git can't just store an empty tree for empty dirs. EDIT: did the Gist https://gist.github.com/alvaro-cuesta/bd0234e3e1a66819c7e9e9f2dc587a87 https://gist.github.com/alvaro-cuesta/bd0234e3e1a66819c7e9e9... Notice the `git cat-file -p HEAD^{tree}` outputs.
- iJohnDoe 1y agoWhat is this web site theme or CMS?
- drewsberry 1y agoThere's no CMS, the site is generated from MD/MDX using Astro. The theme is an adapted version of Astro Micro (https://astro.build/themes/details/astro-micro/ https://astro.build/themes/details/astro-micro/). Seems like some people like it and some don't, but I like it so I'm using it
- lemming 1y agoGit refers to the user-friendly commands as “porcelain” Ahhhhahahaha… “user friendly”. When compared to coding the repo by hand, I guess.
- antonvs 1y agoThis is what happens when you let an OS kernel guy write a cli.
- aGHz 1y agoWhen compared to the "plumbing" commands. If you want to know more about git's plumbing vs porcelain metaphor, this is a good quick overview: https://stackoverflow.com/a/39848551 https://stackoverflow.com/a/39848551
- deleted 1y ago[deleted]
- DrBazza 1y agoI'm glad I clicked through to the actual article rather than dismissing it via its slightly silly title. I learnt a few things about git, and I didn't realize that the tool `pigz` existed. Today I learnt...
- jllyhill 1y agoAm I the only one having troubles with the site on mobile? I'm using Firefox on a decent Android phone but the scroll is extremely stuttery and it distracts from the article unfortunately.
- styanax 1y agoThe site is built with a content creation tool which has used a lot of JS and CSS, but the CSS is atrocious in it's automated output so it's triggering the browser to have to interpret the mess of directives in every code block. The tool is generating HTML trash like (brackets replaced for comment to not parse): [span style="--0:#E1E4E8;--1:#24292E"] [/span] ...over and over, essentially giving style directives for every blank space in the code block. A less capable mobile CPU may well have issues rendering this site due to the presence of so much trash CSS inside it guts. $0.02 hth
- drewsberry 1y agoThe site uses Astro (https://astro.build/ https://astro.build/) and the code blocks are generated using Shiki (https://shiki.style/ https://shiki.style/). As Shiki generates the HTML and CSS at build-time instead of requiring runtime JS like alternatives like Prism (https://prismjs.com/#basic-usage https://prismjs.com/#basic-usage), it's actually quite performant. I think it's unlikely that a couple of hundred lines with some empty spans in is going to cause performance issues – imo it's more likely to come from some silly JS somewhere.
- drewsberry 1y agoThere was a silly on scroll listener that was doing basically nothing – I've tried removing that so if you happen to visit again, I'd be very grateful if you could let me know whether it is still happening (I can't reproduce it myself).
- mitchitized 1y agoI closed the tab as soon as I saw `ignorecase = true`. Absolutely NOT going there again. * points at numerous scars and trauma