How to add to tag list with custom Sphinx role

Open
#76 5 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
30/100
Issue type
Feature
Clarity
Needs clarification
Activity status
Stale
Tech stack
python
Domain
documentation

Research direction

The issue does not name a source file or test. Start by examining how the custom Sphinx role is defined and how ABlog builds its tag list and tag links. Done means documenting or implementing a way for the role's person name to appear in the tag list and link to its tag page.

Written by the indexing model from the issue text.

Description

Enhancement Help Wanted
Description

I'm using ablog as a lab notebook. I've created a custom Sphinx role, :person:. The argument to the role would be the name of a person. With this role, I want to do two things:

  1. Add the name to the tag list.
  2. Make the text a link to the tag.

It wasn't clear to me how to do this and was hoping someone could advise me on how to do this.

Dominant language
Python
Stars
196
Forks
64
PR merge metrics
No merged PRs in 30d

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from sunpy/ablog

All issues in sunpy/ablog

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.