change_the_subject 0.3.1 → 0.3.3
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.github/ISSUE_TEMPLATE/new-term-request.yml +29 -0
- data/Gemfile.lock +1 -1
- data/README.md +12 -4
- data/config/change_the_subject.yml +15 -3
- data/lib/change_the_subject/version.rb +1 -1
- metadata +3 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 93a323c7be102c29ca27cedee07f7586bc3e88fb5829b2b4841f8e8ec903aebc
|
|
4
|
+
data.tar.gz: 7355143afda00985700ff78493630baff96bdc3055c46dac4d64f79aa5b0c69a
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: efb4a20422392edf75953446de51330ef54056fb24397fe6f9a7c5f42d50164f94ffe492c43a521989b4da053199feca10b81498ceb71f308f7e9aff7a7d3fe1
|
|
7
|
+
data.tar.gz: a15d48cf4ce21d3d8fcd35ab8ae63c5dd6b9a58370635c946e1eb0224749826ea0323cd97f786b8f3be1c967a48101f3aa8d511f8ecd5745bf5a74dc27cbd679
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
name: New term request
|
|
2
|
+
description: Request a new term to be masked from the public catalog
|
|
3
|
+
title: "[New term request]: "
|
|
4
|
+
labels: ["new term request"]
|
|
5
|
+
body:
|
|
6
|
+
- type: input
|
|
7
|
+
attributes:
|
|
8
|
+
label: Original term
|
|
9
|
+
description: The term that you want to be masked
|
|
10
|
+
validations:
|
|
11
|
+
required: true
|
|
12
|
+
- type: input
|
|
13
|
+
attributes:
|
|
14
|
+
label: Replacement term
|
|
15
|
+
description: The term that you want to be displayed instead of the original term
|
|
16
|
+
validations:
|
|
17
|
+
required: true
|
|
18
|
+
- type: textarea
|
|
19
|
+
attributes:
|
|
20
|
+
label: Brief rationale
|
|
21
|
+
description: This is the text that will be placed in [config/change_the_subject.yml](https://github.com/pulibrary/change_the_subject/blob/main/config/change_the_subject.yml)
|
|
22
|
+
validations:
|
|
23
|
+
required: true
|
|
24
|
+
- type: input
|
|
25
|
+
attributes:
|
|
26
|
+
label: Link to decision document
|
|
27
|
+
description: Optionally, link to longer document describing the decision
|
|
28
|
+
validations:
|
|
29
|
+
required: false
|
data/Gemfile.lock
CHANGED
data/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# ChangeTheSubject
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
This gem is currently used to mask outdated Library of Congress Subject Headings in two different public access catalogs - [Princeton University Library Catalog](https://catalog.princeton.edu/) and [Princeton University Library Finding Aids](https://findingaids.princeton.edu/).
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
The code for this gem started in the [bibdata codebase](https://github.com/pulibrary/bibdata), the application that prepares metadata for use by the Catalog, and you can [see the gem's earlier history there](https://github.com/pulibrary/bibdata/commits/590d2437126150d66e40393724f9e11ba95c3328/marc_to_solr/lib/change_the_subject.rb).
|
|
6
6
|
|
|
7
7
|
## Installation
|
|
8
8
|
|
|
@@ -21,8 +21,15 @@ Or install it yourself as:
|
|
|
21
21
|
$ gem install change_the_subject
|
|
22
22
|
|
|
23
23
|
## Usage
|
|
24
|
+
The main api of the gem is the `ChangeTheSubject.fix` method, which takes an array of subject terms, compares them to the configuration (the default is in `config/change_the_subject.yml`), and replaces the configured terms. You can see how Bibdata uses the gem in its [traject_config.rb](https://github.com/pulibrary/bibdata/blob/main/marc_to_solr/lib/traject_config.rb).
|
|
24
25
|
|
|
25
|
-
|
|
26
|
+
```ruby
|
|
27
|
+
original_subjects = ["Something problematic", "Something not problematic"]
|
|
28
|
+
subjects = ChangeTheSubject.fix(subject_terms: original_subjects)
|
|
29
|
+
# outputs ["Something not problematic from config", "Something not problematic"]
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
The `ChangeTheSubject.fix` method also takes an optional `separators` argument, which you can [see in use in Pulfalight's implementation for eads](https://github.com/pulibrary/pulfalight/blob/main/lib/pulfalight/traject/ead2_config.rb).
|
|
26
33
|
|
|
27
34
|
## Development
|
|
28
35
|
|
|
@@ -31,5 +38,6 @@ After checking out the repo, run `bin/setup` to install dependencies. Then, run
|
|
|
31
38
|
To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
|
|
32
39
|
|
|
33
40
|
## Contributing
|
|
41
|
+
The configuration for this gem is managed by the Inclusive and Reparative Metadata Working Group (IRMWG). Send questions or comments about the configuration to harmfullanguage@princeton.libanswers.com.
|
|
34
42
|
|
|
35
|
-
Bug reports and pull requests are welcome on GitHub at https://github.com/
|
|
43
|
+
Bug reports and pull requests are welcome on GitHub at https://github.com/pulibrary/change_the_subject.
|
|
@@ -48,10 +48,10 @@
|
|
|
48
48
|
rationale: "The term Noncitizen is the term LoC proposed as replacements for aliens and other uses of the word alien in LCSH."
|
|
49
49
|
"Child slaves":
|
|
50
50
|
replacement: "Enslaved children"
|
|
51
|
-
rationale: "In addition to its usage by TRLN, this term falls in line with recommendations included in the community-sourced document P. Gabrielle Foreman, et al.
|
|
51
|
+
rationale: "In addition to its usage by TRLN, this term falls in line with recommendations included in the community-sourced document P. Gabrielle Foreman, et al. \"Writing about Slavery/Teaching About Slavery: This Might Help\" and Archives for Black Lives in Philadelphia Anti-Racist Description Resources."
|
|
52
52
|
"Indian slaves":
|
|
53
|
-
replacement: "Enslaved
|
|
54
|
-
rationale: "In addition to its usage by TRLN, this term falls in line with recommendations included in the community-sourced document P. Gabrielle Foreman, et al.
|
|
53
|
+
replacement: "Enslaved Indigenous peoples"
|
|
54
|
+
rationale: "In addition to its usage by TRLN, this term falls in line with recommendations included in the community-sourced document P. Gabrielle Foreman, et al. \"Writing about Slavery/Teaching About Slavery: This Might Help.\" Capitalization of \"Indigenous\" appears to be preferred by those from Indigenous communities, for example see https://www.lib.sfu.ca/about/branches-depts/slc/writing/inclusive-antiracist-writing/bipoc and https://www.ictinc.ca/blog/indigenous-peoples-terminology-guidelines-for-usage. As this is a broad term, when possible, one should include the name of the community(ies) or nation(s) of the people in the record. "
|
|
55
55
|
"Older slaves":
|
|
56
56
|
replacement: "Enslaved older people"
|
|
57
57
|
rationale: "The use of \"enslaved\" falls in line with recommendations included in the community-sourced document P. Gabrielle Foreman, et al. \"Writing about Slavery/Teaching About Slavery: This Might Help\" and Archives for Black Lives in Philadelphia Anti-Racist Description Resources. \"Older people\" is the current LC preferred term: https://id.loc.gov/search/?q=memberOf:http://id.loc.gov/authorities/demographicTerms/collection_LCDGT_Age. "
|
|
@@ -61,6 +61,12 @@
|
|
|
61
61
|
"Women slaves":
|
|
62
62
|
replacement: "Enslaved women"
|
|
63
63
|
rationale: "In addition to its usage by TRLN, this term falls in line with recommendations included in the community-sourced document P. Gabrielle Foreman, et al. \"Writing about Slavery/Teaching About Slavery: This Might Help\" and Archives for Black Lives in Philadelphia Anti-Racist Description Resources."
|
|
64
|
+
"East Indians":
|
|
65
|
+
replacement: "Indians (India)"
|
|
66
|
+
rationale: "\"East Indians\" is anachronistic and confusing to researchers. \"East\" is not used with \"Indians\" by the people who live in India, people who once lived in India, or even by the former colonizers of India at this point in time."
|
|
67
|
+
"Indians":
|
|
68
|
+
replacement: "Indigenous peoples of the Western Hemisphere"
|
|
69
|
+
rationale: "Using the scope note from the LCSH term, rather than the term \"Indians,\" is more accurate and less offensive for so many people under this large geographical umbrella."
|
|
64
70
|
"Indians of Central America":
|
|
65
71
|
replacement: "Indigenous peoples of Central America"
|
|
66
72
|
rationale: "This term is used by TRLN; according to our research, this terminology is preferred and widely regarded as a more inclusive term. It is important to include the geographic region in the subject term when possible, as there are Indigenous peoples throughout the world. When possible, it is respectful to also include the name of the community(ies) or nation(s) of the people in the record, for example \"Chumash,\" \"Tonkawa,\" \"Rapa Nui,\" \"Huetar.\""
|
|
@@ -79,3 +85,9 @@
|
|
|
79
85
|
"Gender identity disorders":
|
|
80
86
|
replacement: "Gender dysphoria"
|
|
81
87
|
rationale: '"Gender identity disorder" was removed from the DSM -- the primary diagnostic manual used by psychiatric and psychological professionals in the U.S. -- nearly a decade ago, and replaced with "Gender dysphoria."'
|
|
88
|
+
"Gender identity disorders in children":
|
|
89
|
+
replacement: "Gender dysphoria in children"
|
|
90
|
+
rationale: '"Gender identity disorder" was removed from the DSM -- the primary diagnostic manual used by psychiatric and psychological professionals in the U.S. -- nearly a decade ago, and replaced with "Gender dysphoria."'
|
|
91
|
+
"Gender identity disorders in adolescence":
|
|
92
|
+
replacement: "Gender dysphoria in adolescence"
|
|
93
|
+
rationale: '"Gender identity disorder" was removed from the DSM -- the primary diagnostic manual used by psychiatric and psychological professionals in the U.S. -- nearly a decade ago, and replaced with "Gender dysphoria."'
|
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: change_the_subject
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.3.
|
|
4
|
+
version: 0.3.3
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Max Kadel
|
|
@@ -11,7 +11,7 @@ authors:
|
|
|
11
11
|
autorequire:
|
|
12
12
|
bindir: exe
|
|
13
13
|
cert_chain: []
|
|
14
|
-
date:
|
|
14
|
+
date: 2023-07-07 00:00:00.000000000 Z
|
|
15
15
|
dependencies:
|
|
16
16
|
- !ruby/object:Gem::Dependency
|
|
17
17
|
name: yaml
|
|
@@ -105,6 +105,7 @@ extensions: []
|
|
|
105
105
|
extra_rdoc_files: []
|
|
106
106
|
files:
|
|
107
107
|
- ".circleci/config.yml"
|
|
108
|
+
- ".github/ISSUE_TEMPLATE/new-term-request.yml"
|
|
108
109
|
- ".gitignore"
|
|
109
110
|
- ".rspec"
|
|
110
111
|
- ".rubocop.yml"
|