~netlandish/linktaco-blog

08120d26987c9ed157b706b9d58753f2f8672a0f — Peter Sanchez 14 days ago c609745
Adding new api.linktaco.com post. Also added authors to each post
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 }}

Do not follow this link