M .gitignore => .gitignore +1 -0
@@ 4,3 4,4 @@ test-article.md
.hugo_build.lock
wring.sh
data/openring.toml
+notes.txt
M archetypes/default.md => archetypes/default.md +1 -0
@@ 1,4 1,5 @@
+++
+author = 'Peter Sanchez'
title = '{{ replace .File.ContentBaseName "-" " " | title }}'
date = {{ .Date }}
lastmod = {{ .Date }}
M content/announcing-link-taco.md => content/announcing-link-taco.md +1 -0
@@ 1,4 1,5 @@
+++
+author = 'Peter Sanchez'
title = 'Announcing Link Taco'
date = 2025-01-07T06:27:39-06:00
lastmod = 2025-01-07T06:27:39-06:00
A content/new-api-documentation-api-linktaco-com.md => content/new-api-documentation-api-linktaco-com.md +61 -0
@@ 0,0 1,61 @@
++++
+author = 'Peter Sanchez'
+title = 'New API documentation on api.linktaco.com'
+date = 2025-04-24T07:26:07-06:00
+lastmod = 2025-04-24T07:26:07-06:00
+tags = ['api', 'documentation', 'graphql']
+summary = 'Announcing the new API schema documentation on api.linktaco.com'
+description = 'Announcing the new API schema documentation on api.linktaco.com'
+keywords = ['api', 'documentation', 'graphql']
+draft = false
++++
+
+[GraphQL][gql] is not a new API format, but it's definitely not as
+familiar or widely used as, say, [REST][]. Because it's less common, many
+developers hesitate when they have to interact with GraphQL. Once they get over
+the initial learning curve, they're usually are quite pleased with it and can see
+the power and trade-offs it provides compared other API integrations.
+
+At LinkTaco, we're fully powered by GraphQL. We already provide some
+[documentation][doc] on working with our API server, as well as a [GraphQL
+Playground][play] to test your queries. Today, we're excited to share
+even more documentation to help developers better understand our schema.
+
+Announcing our new [api.linktaco.com][api] site.
+
+This site provides you the entire GraphQL API Schema on a single page. It
+shows all queries, mutations, directives, types, and more. You'll even find
+example queries you can copy and paste into the [GraphQL Playground][play] for
+testing.
+
+We hope this is useful and helps you create some awesome integrations
+with the platform. As always, feel free to email the [development mailing
+list][dev] with any questions.
+
+Of course, you can check out the [repository][repo] for the new API docs if you want
+to see how the sausage is made. If you have any issues or suggestions, please
+don't hesitate to [let us know][luk].
+
+## Thanks to Sourcehut
+
+As always, the folks over at [Sourcehut][srht] are churning out useful software
+at neck-break speeds. This documentation was made possible by [Conrad
+Hoffman][ch] and his [dockel][] tool for auto-generating GraphQL documentation. I,
+of course, used and modified the [docs.sourcehut.org][docs] repo for their
+templates to create the documentation on [api.linktaco.com][api].
+
+Thanks to these tools, I was able to produce the new documentation site in under
+an hour.
+
+[gql]: https://graphql.org "GraphQL"
+[rest]: https://en.wikipedia.org/wiki/REST "RESTful"
+[doc]: https://man.code.netlandish.com/~netlandish/links/graphql.md "LinkTaco GraphQL"
+[api]: https://api.linktaco.com "LinkTaco API docs"
+[play]: https://linktaco.com/graphql "LinkTaco GraphQL Playground"
+[dev]: https://lists.code.netlandish.com/~netlandish/links-dev "Developmnet Mailing List"
+[luk]: https://lists.code.netlandish.com/~netlandish/links-discuss "Discussion Mailing List"
+[srht]: https://sourcehut.org "Sourcehut"
+[gockel]: https://git.sr.ht/~bitfehler/gockel "gockel repo"
+[docs]: https://git.sr.ht/~bitfehler/docs.sourcehut.org "docs.sourcehut.org repo"
+[ch]: https://bitfehler.net/ "Conrad Hoffman"
+[repo]: https://git.code.netlandish.com/~netlandish/api.linktaco.com "API Docs Repo"
M content/new-linktaco-release-0.2.0.md => content/new-linktaco-release-0.2.0.md +1 -0
@@ 1,4 1,5 @@
+++
+author = 'Peter Sanchez'
title = 'New LinkTaco Release: 0.2.0'
date = 2025-03-08T10:52:14-06:00
lastmod = 2025-03-08T10:52:14-06:00
M content/new-linktaco-release-0.3.0.md => content/new-linktaco-release-0.3.0.md +1 -0
@@ 1,4 1,5 @@
+++
+author = 'Peter Sanchez'
title = 'New LinkTaco Release: 0.3.0'
date = 2025-04-03T06:52:14-06:00
lastmod = 2025-04-03T06:52:14-06:00
M content/testing-anubis-stop-ai-scrapers.md => content/testing-anubis-stop-ai-scrapers.md +1 -0
@@ 1,4 1,5 @@
+++
+author = 'Peter Sanchez'
title = 'Testing Anubis to try and stop AI scrapers'
date = 2025-03-21T07:24:25-06:00
lastmod = 2025-03-21T07:24:25-06:00
M content/why-pinboard-falls-short-what-we-built-instead.md => content/why-pinboard-falls-short-what-we-built-instead.md +1 -0
@@ 1,4 1,5 @@
+++
+author = 'Peter Sanchez'
title = 'Why Pinboard Falls Short and What We Built Instead'
date = 2025-02-11T06:00:00-06:00
lastmod = 2025-02-11T06:00:00-06:00
M layouts/_default/list.html => layouts/_default/list.html +1 -1
@@ 10,7 10,7 @@
{{ range .Pages.ByPublishDate.Reverse }}
<div class="row">
<div class="col-2"><p>{{ .PublishDate.Format .Site.Params.dateFormat }}</p></div>
- <div class="col"><p><a href="{{ .RelPermalink }}">{{ .Title }}</a></p></div>
+ <div class="col"><p><a href="{{ .RelPermalink }}">{{ .Title }}</a><br />by {{ .Params.author }}</p></div>
</div>
{{ end }}
</section>
M layouts/_default/single.html => layouts/_default/single.html +1 -1
@@ 5,7 5,7 @@
<section class="blog-header">
<h1 class="app-header__title">{{ .Title }}</h1>
</section>
-<section class="blog-date">Published: {{ .PublishDate.Format .Site.Params.dateFormat }} in
+<section class="blog-date">Published: {{ .PublishDate.Format .Site.Params.dateFormat }} by {{ .Params.author }} in
{{ with .GetTerms "tags" }}
{{ range $i, $l := . }}{{ if $i }}, {{ end }}<a href="{{ $l.RelPermalink }}">{{ $l.LinkTitle }}</a>{{end }}
{{ end }}