Skip to content

Commit 8bc45aa

Browse files
committed
Split table of schema.org terms between Software and Person properties.
1 parent 6544d63 commit 8bc45aa

File tree

2 files changed

+96
-7
lines changed

2 files changed

+96
-7
lines changed

content/terms.Rmd

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -11,31 +11,37 @@ library("dplyr")
1111

1212
## Terms from Schema.org
1313

14-
Recognized properties for CodeMeta `Code` includes the following terms from <https://schema.org>. These terms are part of the CodeMeta specification and can be used without any prefix.
14+
Recognized properties for CodeMeta `SoftwareSourceCode` and `SoftwareApplication` includes the following terms from <https://schema.org>. These terms are part of the CodeMeta specification and can be used without any prefix.
1515

1616
```{r}
1717
crosswalk <- "https://github.com/codemeta/codemeta/raw/master/crosswalk.csv"
1818
cw <- read_csv(crosswalk)
19-
cw %>%
20-
filter(grepl("schema:", `Parent Type`)) %>%
19+
cw %>%
20+
filter(grepl("schema:(SoftwareSourceCode|SoftwareApplication|CreativeWork|Thing)", `Parent Type`)) %>%
2121
select(Property, Type, Description) %>%
2222
knitr::kable("html", table.attr="class=\"table table-striped\"")
23-
2423
```
2524

2625
These terms are all recognized properties of <https://schema.org/SoftwareSourceCode> or <https://schema.org/SoftwareApplication> Types. Note that while most properties take basic data types as values (`Text`, `URL`), several take other node types, such as `Person` or `Organization`. Recommended fields for these node types in CodeMeta documents are given below.
2726

27+
```{r}
28+
cw %>%
29+
filter(grepl("schema:(Person|Thing)", `Parent Type`)) %>%
30+
select(Property, Type, Description) %>%
31+
knitr::kable("html", table.attr="class=\"table table-striped\"")
32+
```
33+
2834
## Codemeta terms
2935

3036
The CodeMeta project also introduces the following additional properties, which lack clear equivalents in <https://schema.org> but can play an important role in software metadata records covered by the CodeMeta crosswalk.
3137

3238
```{r}
33-
cw %>%
39+
cw %>%
3440
filter(grepl("codemeta:", `Parent Type`)) %>%
3541
select(Property, Type, Description) %>%
3642
knitr::kable("html", table.attr="class=\"table table-striped\"")
3743
3844
```
3945

4046

41-
Please suggest additional terms or adjustments to this representation in the [codemeta issues](https://github.com/codemeta/codemeta/issues)
47+
Please suggest additional terms or adjustments to this representation in the [codemeta issues](https://github.com/codemeta/codemeta/issues)

content/terms.html

Lines changed: 84 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -562,6 +562,90 @@ <h2>Terms from Schema.org</h2>
562562
A link related to this object, e.g. related web pages
563563
</td>
564564
</tr>
565+
</tbody>
566+
</table>
567+
<p>These terms are all recognized properties of <a href="https://schema.org/SoftwareSourceCode" class="uri">https://schema.org/SoftwareSourceCode</a> or <a href="https://schema.org/SoftwareApplication" class="uri">https://schema.org/SoftwareApplication</a> Types. Note that while most properties take basic data types as values (<code>Text</code>, <code>URL</code>), several take other node types, such as <code>Person</code> or <code>Organization</code>. Recommended fields for these node types in CodeMeta documents are given below:</p>
568+
<table class="table table-striped">
569+
<thead>
570+
<tr>
571+
<th style="text-align:left;">
572+
Property
573+
</th>
574+
<th style="text-align:left;">
575+
Type
576+
</th>
577+
<th style="text-align:left;">
578+
Description
579+
</th>
580+
</tr>
581+
</thead>
582+
<tbody>
583+
<tr>
584+
<td style="text-align:left;">
585+
description
586+
</td>
587+
<td style="text-align:left;">
588+
Text
589+
</td>
590+
<td style="text-align:left;">
591+
A description of the item.
592+
</td>
593+
</tr>
594+
<tr>
595+
<td style="text-align:left;">
596+
identifier
597+
</td>
598+
<td style="text-align:left;">
599+
PropertyValue or URL
600+
</td>
601+
<td style="text-align:left;">
602+
The identifier property represents any kind of identifier for any kind of Thing, such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See background notes for more details.
603+
</td>
604+
</tr>
605+
<tr>
606+
<td style="text-align:left;">
607+
name
608+
</td>
609+
<td style="text-align:left;">
610+
Text
611+
</td>
612+
<td style="text-align:left;">
613+
The name of the item (software, Organization)
614+
</td>
615+
</tr>
616+
<tr>
617+
<td style="text-align:left;">
618+
sameAs
619+
</td>
620+
<td style="text-align:left;">
621+
URL
622+
</td>
623+
<td style="text-align:left;">
624+
URL of a reference Web page that unambiguously indicates the item’s identity. E.g. the URL of the item’s Wikipedia page, Wikidata entry, or official website.
625+
</td>
626+
</tr>
627+
<tr>
628+
<td style="text-align:left;">
629+
url
630+
</td>
631+
<td style="text-align:left;">
632+
URL
633+
</td>
634+
<td style="text-align:left;">
635+
URL of the item.
636+
</td>
637+
</tr>
638+
<tr>
639+
<td style="text-align:left;">
640+
relatedLink
641+
</td>
642+
<td style="text-align:left;">
643+
URL
644+
</td>
645+
<td style="text-align:left;">
646+
A link related to this object, e.g. related web pages
647+
</td>
648+
</tr>
565649
<tr>
566650
<td style="text-align:left;">
567651
givenName
@@ -641,7 +725,6 @@ <h2>Terms from Schema.org</h2>
641725
</tr>
642726
</tbody>
643727
</table>
644-
<p>These terms are all recognized properties of <a href="https://schema.org/SoftwareSourceCode" class="uri">https://schema.org/SoftwareSourceCode</a> or <a href="https://schema.org/SoftwareApplication" class="uri">https://schema.org/SoftwareApplication</a> Types. Note that while most properties take basic data types as values (<code>Text</code>, <code>URL</code>), several take other node types, such as <code>Person</code> or <code>Organization</code>. Recommended fields for these node types in CodeMeta documents are given below.</p>
645728
</div>
646729
<div id="codemeta-terms" class="section level2">
647730
<h2>Codemeta terms</h2>

0 commit comments

Comments
 (0)