squidfunk

7 ms·

31.
by squidfunk 5y ago
Sphinx is Python-specific, and yes, in that instance much more powerful than MkDocs. MkDocs is a general documentation solution, which is language-agnostic. Also, Sphinx is normally written in rST with a steeper learning curve than Markdown
32.
by squidfunk 5y ago
Sure! The README links [1] to several installations used by large Open Source projects and companies. Some prominent examples: - https://fastapi.tiangolo.com/ - https://crystal-lang.org/reference/ - h
33.
by squidfunk 5y ago
Jup, that's sadly a still unfixed bug in Safari [1]. Super annoying, but if we would use px for media queries, we would have to swap out all rem units with px, thus not respecting your default font size. [1]: https://adamwat
34.
by squidfunk 5y ago
Did you maybe use a slow connection? When the search index is ready (it's built client-side in a web worker) it switches from "Initializing search" to "Type to start searching". This can be observed when setting net
35.
by squidfunk 5y ago
True, Material for MkDocs doesn't have a working out-of-the-box solution for working code examples, as it's a language-agnostic theme for documentation, but it shouldn't be too difficult to integrate [1]. [1]: https:/&#
36.
by squidfunk 5y ago
Thanks! To those interested in the mechanics of the Insiders monetization strategy, I've talked more about in [1] [1]: https://news.ycombinator.com/item?id=25884018
37.
by squidfunk 5y ago
Just to clarify: the left-hand sidebar is the navigation, which collapses into the drawer behind the hamburger menu icon on breakpoints below 1220px. The right-hand sidebar is the table of contents which lists all anchor links specific to t
38.
by squidfunk 5y ago
No, it's just a theme for MkDocs [1], a static site generator that has no affiliation with Google. Material for MkDocs only borrows the Material Design philosophy from Google. [1]: https://www.mkdocs.org/
39.
by squidfunk 5y ago
> On the other end of the spectrum you have tools like MkDocs (or mdbook, docsify, docusaurus, etc.) which are more focused on technical docs in markdown format. These tools put much less emphasis on schema, layout, taxonomy and really t
40.
by squidfunk 5y ago
Thanks! I'm glad to hear that. Indeed, a lot of love went into the search and there're still some things that will be improved on the search in the coming months, e.g. more concise search result summaries.
41.
by squidfunk 5y ago
Thanks! > I think the tablet viewport (aka desktop-not-maximized) could use bit more love IMHO, layouts for tablet viewports are often quite frankensteiny and hard to get really great. Is there anything in particular you feel could be im
42.
by squidfunk 5y ago
Author here, AMA!
43.
by squidfunk 6y ago
Thanks! That is great to hear. Making writing documentation as frictionless and easy as possible is the primary goal of this project. Happy to welcome you aboard as a sponsor!
44.
by squidfunk 6y ago
I do 99% of the work, but of course I also accept contributions. However, PRs are very rare and are mostly about bugfixes, not new features. Bugfixes are always released as part of the non-Insiders version, of course. What's probably i
45.
by squidfunk 6y ago
It's MIT-licensed, as the original project. I have no interest in legal prosecution. Also, different licensing would make it more complicated for companies.
46.
by squidfunk 6y ago
This is indeed a problem. However, given that you need to pay for a subscription to get access, I consider the risk rather low. The Insiders code is released under the same license (MIT), as I didn't want to make things complicated, so
47.
by squidfunk 6y ago
> What do you do if the sum of the monthly pledges goes down at some point? Will you make those features private again? Nope, any feature that is released will remain public. > I guess it's a bit counter-intuitive for me that a o
48.
by squidfunk 6y ago
Is it greedy if, after investing months or years of work, answering issues, implementing feature requests, you feel like you deserve to be somehow compensated for your work, especially with successful companies using your software, benefiti
49.
by squidfunk 6y ago
Sponsors have access to the private repository (I'm using GitHub's collaborator feature). I have several sponsor tiers and $10 a month or more will get you access to my sponsorware, which means you will be added to the private rep
50.
by squidfunk 6y ago
I also started with GitHub sponsors after reading about Caleb's post about sponsorware in May 2020 and have managed to grow my sponsorships since then to more than $1k a month. To those who are interested how I did it: I'm the aut
51.
Show HN: Material for MkDocs 6(squidfunk.github.io)
1 points by squidfunk 6y ago|0 comments
52.
by squidfunk 6y ago
Author of protobluff [1] here - a zero-copy, mostly stack-based implementation for Protocol Buffers in C. Yes, you must scan through the message to find the corresponding tag/value pair you're interested in, but in many cases, it
53.
The Cognitive Complexity of CSS(ginseng.ai)
1 points by squidfunk 6y ago|0 comments
54.
Show HN: Serverless Authentication as a Service Provider on top of AWS Cognito(github.com)
7 points by squidfunk 8y ago|2 comments
55.
Why screenshot testing on BrowserStack or SauceLabs is broken by design(github.com)
1 points by squidfunk 9y ago|0 comments
56.
by squidfunk 9y ago
I'm the author of the Material theme which actually has a top bar, a feature called tabs, see http://squidfunk.github.io/mkdocs-material/getting-started/#...
57.
Ask HN: Reading recommendations on Browser internals, part. layout/rendering
4 points by squidfunk 9y ago|0 comments
58.
Material for MkDocs 1.0.0 released – a complete overhaul(squidfunk.github.io)
2 points by squidfunk 10y ago|0 comments
59.
Show HN: A web scraper to obtain lists of anonymous proxies for web scraping(gist.github.com)
3 points by squidfunk 11y ago|0 comments
60.
Show HN: A material design theme for MkDocs(squidfunk.github.io)
3 points by squidfunk 11y ago|0 comments

More ›