search

scholarslab / scholarslab.github.io

World Wide Web site! For the Scholars' Lab!
https://scholarslab.lib.virginia.edu
12 stars 7 forks source link

Post tags & categories #1021

Closed amandavisconti closed 2 months ago

amandavisconti commented 3 months ago

Moving this from where it started as part of #918.

Categories Redux

  1. Categories are now only 3 things: update, announcement, or essay.
  2. Only pick one, not multiple.
  3. I've already switched past categories on every post to be tags instead.
  4. Updates use a different/_layout file than posts (because of lack of metadata, cite script)
  5. only use tags on category: essay going forward (not update, announcement)

category: update

category: announcement:

category: essay:

YAML should look like: category: update category: announcement category: essay

amandavisconti commented 3 months ago

Tags redux

Tags are not meant to describe everything about a post. Tags are only used when:

  1. multiple other posts with same tag exist, or are planned in the near future
  2. we want to be able to pull the post into a section of the website titled with its name (e.g. a SLab blog OER table of contents with a methods section that includes code, gis, 3D scanning)

Tags we're keeping, below! (Note these are now all lowercase, even acronyms and "3d")

Tags to actively use & add to posts they're missing from

(spatial tech)

(meta academia)

(departments/department-level fields of study)

(topics & methods that aren't department-level fields)

Can go on posts that are about one of these, even if the author isn't in a department with that name.

(misc)

(learning & teaching -ish)

(students/fellows)

(named projects)

(code + design)

(makerspace)

Don't add to new things, but keeping on old posts

Podcasts Event (we use /_collections/_events for these now)

amandavisconti commented 3 months ago
  1. Case matters in tags. ~Need to convert each tag into only using lowercase~ (done!), and document.
  2. ~check if spaces matter (e.g. praxis program)~ they do not, except different code is needed to display a loop of the posts per that tag (see e.g. /work/cultural-heritage-informatic-documentation for an example of this, as loop at bottom uses "parents fund" tag that has space in it). document this!
  3. ~create page that displays all tags to help notice things we want to 1) delete or 2) tag onto more relevant posts (and add to above list of new tags)~ done (/pages/tags.html). updates above list from tags.html
amandavisconti commented 3 months ago

Will likely want to ask for volunteers to take from the things below to help improve post tagging, to better create a very cool OER textbook (see #1022 )

Add to any posts missing these:

Figure out/disambiguate/remove or add/involved tagging tasks

amandavisconti commented 3 months ago

Create a page listing all tags, then listing each tag again, with posts using that tag under it:

---
layout: page
title: Essay Tags
permalink: /tags/
---

<div>
<!-- list of all tags used in site posts -->
    <div>
        <ul>
            {% assign sorted_tags = site.tags | sort %}
            {% for tag in sorted_tags %}
                <li><a href="#{{ tag[0] | slugify }}" class="post-tag">{{ tag[0] }}</a></li>
            {% endfor %}
        </ul>
    </div>

<hr/>
<!-- Each tag, with posts using the tag beneath it. Posts may appear under multiple tag sections due to having multiple tags. -->
    <div>
        {% for tag in site.tags %}
            <h2 id="{{ tag[0] | slugify }}">{{ tag | first }}</h2>
            <ul>
                {% for post in tag[1] %}
                    <a class="post-title" href="{{ site.baseurl }}{{ post.url }}">
                    <li>
                        {{ post.title }}
                        <small class="post-date">{{ post.date | date_to_string }}</small>
                    </li>
                    </a>
                {% endfor %}
            </ul>
        {% endfor %}
    </div>
</div>
amandavisconti commented 3 months ago

Changed the category formerly known as "blog" to "essay", for clarity that this is not the same as all blog posts

amandavisconti commented 2 months ago

I created a spreadsheet version for easier updating, and so I can share with Laura

amandavisconti commented 2 months ago

Closing this issue as encompassing summer 2024 work. New issue #1074 continues it, with a clean message thread containing lastest status.