Skip to content

Commit fff90fe

Browse files
jchiquetclaude
andcommitted
Fix Google Scholar blog post and redirect the old reviewers guidelines URL
- blog: citation_pdf_url was actually missing until 2026-09-15 (update callout), Quarto (not the extension) generates the tags, correct citation YAML keys (container-title, issn, pdf-url -> main.pdf), citation_fulltext_html_url, warning to keep metadata in _quarto.yml, 16 (not 18) non-indexed articles - guidelines-reviewers: alias for the old /guidelines-reviewers URL (404 in Search Console) Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1 parent 188a5da commit fff90fe

2 files changed

Lines changed: 41 additions & 20 deletions

File tree

‎blog/2026-07-26-google-scholar/index.qmd‎

Lines changed: 39 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: Google Scholar Indexing
33
date: '2026-07-26'
4+
date-modified: '2026-09-16'
45
description: How Computo ensures Google Scholar indexing and understanding URL selection
56
categories:
67
- indexing
@@ -29,51 +30,58 @@ Computo articles also include the following recommended tags for richer indexing
2930

3031
- `citation_journal_title` -- "Computo"
3132
- `citation_issn` -- "2824-7795"
32-
- `citation_pdf_url` -- link to the article PDF
33-
- `citation_abstract_html_url` -- link to the article landing page
33+
- `citation_pdf_url` -- link to the article PDF (`main.pdf`)
34+
- `citation_fulltext_html_url` -- link to the article landing page
3435
- `citation_doi` -- the article DOI
3536

3637
### The `google-scholar` flag
3738

38-
All Computo article repositories include `google-scholar: true` in their `_quarto.yml` configuration. When this flag is set, the [Computo Quarto extension](https://github.com/computorg/computo-quarto-extension) automatically generates the complete set of Highwire Press meta tags from the article's frontmatter and `citation:` block. This happens at render time -- no manual intervention is needed.
39+
All Computo article repositories include `google-scholar: true` in their `_quarto.yml` configuration. When this flag is set, [Quarto](https://quarto.org/docs/authoring/create-citeable-articles.html#google-scholar) itself generates the complete set of Highwire Press meta tags at render time, from the document metadata (`title`, `author`, `date`) and from the `citation:` block. No manual intervention is needed.
3940

40-
Here is what the configuration looks like in a published article's `_quarto.yml`:
41+
Here is what the configuration looks like in a published article's `_quarto.yml` (for a repository named `published-YYYYMM-name`):
4142

4243
```yaml
44+
title: "Article Title"
45+
author:
46+
- name: "Author Name"
47+
orcid: 0000-0000-0000-0000
48+
affiliations:
49+
- name: "Institution"
50+
date: 2024-01-01
4351
google-scholar: true
4452
citation:
45-
title: "Article Title"
46-
author:
47-
- id: author1
48-
name: "Author Name"
49-
affiliation: "Institution"
50-
date: 2024-01-01
51-
doi: "10.57750/xxxxx"
52-
journal: "Computo"
53+
type: article-journal
54+
container-title: "Computo"
5355
publisher: "French Statistical Society"
54-
ISSN: "2824-7795"
55-
url: "https://computo-journal.org/article-slug/"
56-
pdf: "article-slug.pdf"
57-
abstract: "..."
56+
issn: "2824-7795"
57+
doi: "10.57750/xxxxx"
58+
url: "https://computo-journal.org/published-YYYYMM-name/"
59+
pdf-url: "https://computo-journal.org/published-YYYYMM-name/main.pdf"
5860
```
5961
62+
::: {.callout-warning}
63+
### Keep all metadata in `_quarto.yml`
64+
Do not repeat metadata in the front matter of `main.qmd`. A `citation:` block there **replaces** the one in `_quarto.yml` entirely (dropping `url` and `pdf-url`), and an `author:` list that differs from the one in `_quarto.yml` leads to duplicated authors in the generated citation.
65+
:::
66+
6067
From this, Quarto generates HTML meta tags like:
6168

6269
```html
6370
<meta name="citation_title" content="Article Title">
6471
<meta name="citation_author" content="Author Name">
65-
<meta name="citation_publication_date" content="2024/01/01">
72+
<meta name="citation_publication_date" content="2024-01-01">
6673
<meta name="citation_journal_title" content="Computo">
6774
<meta name="citation_issn" content="2824-7795">
68-
<meta name="citation_pdf_url" content="https://computo-journal.org/article-slug/article-slug.pdf">
75+
<meta name="citation_fulltext_html_url" content="https://computo-journal.org/published-YYYYMM-name/">
76+
<meta name="citation_pdf_url" content="https://computo-journal.org/published-YYYYMM-name/main.pdf">
6977
<meta name="citation_doi" content="10.57750/xxxxx">
7078
```
7179

7280
### Additional discoverability features
7381

7482
Beyond meta tags, Computo articles benefit from several features that help Google Scholar's crawlers:
7583

76-
- **Sitemap**: Quarto auto-generates a `sitemap.xml` (thanks to `site-url` being configured in the main site's `_quarto.yml`), which helps search engines discover all article URLs.
84+
- **Sitemap**: Quarto auto-generates a `sitemap.xml` for the journal website (thanks to `site-url` being configured in the main site's `_quarto.yml`), and a post-render script adds the URL of every published article, which helps search engines discover them.
7785
- **Open access**: All articles are freely accessible without login walls or paywalls, meeting Google Scholar's requirement for crawlable full text.
7886
- **Stable URLs**: Each article has a permanent URL on `computo-journal.org` and a DOI, ensuring persistent access.
7987
- **Abstract visibility**: The full author-written abstract is clearly visible on each article's landing page.
@@ -115,6 +123,17 @@ For the full official documentation, see Google Scholar's [Inclusion Guidelines
115123

116124
## Indexing status report
117125

126+
::: {.callout-important}
127+
### Update: September 2026
128+
A September 2026 audit found that, contrary to what this post initially stated, the `citation_pdf_url` tag was **missing from all Computo articles** until September 15, 2026, as well as from two landing pages that were redirect-only. All articles have since been fixed:
129+
130+
- every article now declares `pdf-url` in its `citation:` block, and the tag is present on all article pages;
131+
- article metadata was moved from `main.qmd` to `_quarto.yml`, which also removed duplicated authors from the generated citation of three articles;
132+
- re-indexing of all article pages has been requested through Google Search Console.
133+
134+
The report below reflects the July 2026 situation, before these fixes.
135+
:::
136+
118137
::: {.callout-note}
119138
### Report date: July 2026
120139
The following status was verified by searching Google Scholar for each published article.
@@ -139,7 +158,7 @@ The following status was verified by searching Google Scholar for each published
139158

140159
### Not yet indexed in Google Scholar
141160

142-
The following 18 published articles were **not found** in Google Scholar as of July 2026:
161+
The following 16 published articles were **not found** in Google Scholar as of July 2026:
143162

144163
| # | Article | Authors | Year |
145164
|---|---------|---------|------|

‎site/guidelines-reviewers.qmd‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
---
22
title: Reviewing for Computo
33
description: Guidelines for reviewers
4+
aliases:
5+
- /guidelines-reviewers
46
format:
57
html: {}
68
page-layout: article

0 commit comments

Comments
 (0)