Skip to content

Commit

Permalink
Merge pull request #140 from otili9890/main
Browse files Browse the repository at this point in the history
README implementation into About page
  • Loading branch information
otili9890 authored Jun 13, 2024
2 parents 0852a55 + bb80cf3 commit b58b9e3
Show file tree
Hide file tree
Showing 5 changed files with 4,932 additions and 59 deletions.
22 changes: 11 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,22 @@

<!---Start--->
# Crate-O

<!---End--->
Status: Crate-O is now usable in Chromium-based browsers (Chrome, and Microsoft Edge work) - you can try it [here](https://language-research-technology.github.io/crate-o/), please let report bugs using Github issues in this repository.

Crate-O is a browser-based editor for Research Object Crates ([RO-Crate]). RO-Crate is a flexible, developer-friendly approach to linked-data description and packaging. Crate-O is designed to:
<!---Start--->
Crate-O is a browser-based editor for Research Object Crates [(RO-Crate)](https://www.researchobject.org/ro-crate/). RO-Crate is a flexible, developer-friendly approach to linked-data description and packaging. Crate-O is designed to:
- describe files on a user’s computer and to add contextual information about those files
- optionally skip the files and describe abstract contextual entities such as in a Cultural Collection or an encyclopaedia
- annotate existing resources elsewhere on the web
- import bulk metadata from an Excel spreadsheet

<!---End--->
For more technical information on Crate-O, refer to the [Developer Documentation page](./docs)
<!---Start--->
NOTE: Crate-O is for Google Chrome and related browsers ONLY at this stage as it describes files on the users computer, and saves RO-Crate metadata there. We will be releasing a version that can be deployed as part of a service that accesses online resources directly, which will be compatible with other browsers (see the [Roadmap](https://github.com/Language-Research-Technology/crate-o#roadmap--backlog)).

NOTE: Crate-O is for Google Chrome and related browsers ONLY at this stage as it describes files on the users computer, and saves RO-Crate metadata there. We will be releasing a version that can be deployed as part of a service that accesses online resources directly, which will be compatible with other browsers (see the [Roadmap]).

While the current version of Crate-O is designed for editing self-contained RO-Crates (and works fine with crates containing tens of thousands of entities) - our roadmap includes editing fragments of larger linked-data resources, and integration with Arkisto repositories such as the [Oni] repository, data API & search portal.

Crate-O is currently developed by the Language Data Commons of Australia ([LDaCA]), under the guidance of Peter Sefton as technical lead. If the tool is adopted in other contexts (we are in talks with a few groups about this) then we aim to establish a steering committee / reference group to help guide development.
While the current version of Crate-O is designed for editing self-contained RO-Crates (and works fine with crates containing tens of thousands of entities) - our roadmap includes editing fragments of larger linked-data resources, and integration with Arkisto repositories such as the [Oni](https://github.com/Language-Research-Technology/oni) repository, data API & search portal.

Crate-O is currently developed by the Language Data Commons of Australia [(LDaCA)](https://www.ldaca.edu.au/), under the guidance of Peter Sefton as technical lead. If the tool is adopted in other contexts (we are in talks with a few groups about this) then we aim to establish a steering committee / reference group to help guide development.
<!---End--->
# History

Crate-O was is a rewrite of a tool called [Describo]. Though members of the Crate-O tool were involved in its conception, funding and development we are no longer associated with that line of development.
Expand Down Expand Up @@ -109,4 +109,4 @@ Potential work on Cultural collections will be enabled by the other functions w



1. Verhoeven D, Burrows T. Aggregating Cultural Heritage Data for Research Use: the Humanities Networked Infrastructure (HuNI). In: Garoufallou E, Hartley RJ, Gaitanou P, editors. Metadata and Semantics Research. Cham: Springer International Publishing; 2015. p. 417–23. (Communications in Computer and Information Science).
1. Verhoeven D, Burrows T. Aggregating Cultural Heritage Data for Research Use: the Humanities Networked Infrastructure (HuNI). In: Garoufallou E, Hartley RJ, Gaitanou P, editors. Metadata and Semantics Research. Cham: Springer International Publishing; 2015. p. 417–23. (Communications in Computer and Information Science).
24 changes: 18 additions & 6 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

7 changes: 4 additions & 3 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "crate-o",
"version": "0.3.12",
"version": "0.3.13",
"description": "A VueJS UI component to create and edit Research Object Crate (RO-Crate) metadata",
"keywords": [
"RO-Crate",
Expand Down Expand Up @@ -43,7 +43,7 @@
},
"scripts": {
"dev": "vite",
"build": "vite build",
"build": "vite build && cp README.md dist",
"build:library": "vite build --mode library",
"preview": "vite preview --port 5000",
"test": "cypress run --component --headless",
Expand All @@ -58,11 +58,12 @@
"leaflet-editable": "^1.2.0",
"leaflet-gesture-handling": "^1.2.2",
"leaflet.path.drag": "^0.0.6",
"marked": "^13.0.0",
"mime": "^4.0.1",
"ro-crate": "^3.3.9"
},
"peerDependencies": {
"element-plus": "^2.6.0",
"element-plus": "^2.7.5",
"vue": "^3.4.21"
},
"devDependencies": {
Expand Down
96 changes: 57 additions & 39 deletions src/app/components/About.vue
Original file line number Diff line number Diff line change
@@ -1,50 +1,68 @@
<script setup>
import { marked } from 'marked';
fetch('./README.md')
.then(response => response.text())
.then(markdown => {
const htmlContent = marked(slice_anchors(markdown));
document.getElementById("about_html_content").innerHTML = htmlContent;
})
.catch(error => console.error('Error fetching the Markdown file:', error))
// Finds indexes of substrings in string
function indexes(substring, string){
var a=[],i=-1;
while((i=string.indexOf(substring,i+1)) >= 0) {
substring.includes("Start") ? a.push([i + 14]) : a.push(i);
}
return a;
}
function slice_anchors(markdown) {
var starts = indexes("<!---Start--->", markdown);
var ends = indexes("<!---End--->", markdown);
var md_sliced = "";
try {
for (let i = 0; i < starts.length; i++) {
md_sliced += markdown.slice(starts[i], ends[i]);
}
return md_sliced;
} catch(err) {
console.log(err);
}
}
//TODO: Insert code that will load the readme markdown into here as html
</script>
<style>
#about_html_content h1 {
@apply mb-3 text-xl md:text-xl text-gray-500
}
#about_html_content h2 {
@apply mb-3 text-lg md:text-xl text-gray-500
}
#about_html_content div {
@apply grid gap-2 text-gray-500 dark:text-gray-400 grid gap-2
}
#about_html_content a {
@apply text-blue-600 dark:text-blue-500 hover:underline
}
#about_html_content ul {
@apply list-disc list-inside text-gray-500
}
#about_html_content p {
@apply text-gray-500
}
</style>
<template>
<div class="grid gap-2 text-gray-500 dark:text-gray-400" id="about_html_content"></div>
<div class="grid gap-2 text-gray-500 dark:text-gray-400">
<h2 class="mb-3 text-lg md:text-xl">About Crate-O</h2>
<p class="">
Crate-O is a browser-based editor for <a class="text-blue-600 dark:text-blue-500 hover:underline"
href="https://www.researchobject.org/ro-crate" target="_blank" rel="noopener noreferrer">Research Object Crates
(RO-Crate)</a>.
RO-Crate is a flexible,
developer-friendly approach to linked-data description and packaging.
</p>
<p class="">Crate-O is designed to:</p>
<ul class="list-disc list-inside">
<li>describe files on a user’s computer and to add contextual information about those files,</li>
<li>skip the files and describe abstract contextual entities such as in a Cultural Collection or an encyclopaedia,
or</li>
<li>annotate existing resources elsewhere on the web.</li>
</ul>

<br>
<p class="">
Crate-O works only with <a class="text-blue-600 dark:text-blue-500 hover:underline"
href="https://google.com/chrome" target="_blank" rel="noopener noreferrer">Google
Chrome</a> and <a class="text-blue-600 dark:text-blue-500 hover:underline" href="https://microsoft.com/edge"
target="_blank" rel="noopener noreferrer">Microsoft Edge</a> at this stage as it
describes files on the user's
computer, and saves RO-Crate metadata there. We will be releasing versions that work with online resources
directly which will be compatible with other browsers (see the
<!-- I don't know why these hidden links are needed but they are -->
<a class="text-blue-600 dark:text-blue-500 hover:underline"
href="https://github.com/Language-Research-Technology/crate-o#roadmap--backlog" target="_blank"
rel="noopener noreferrer">Roadmap</a>).
</p>
<p class="">
While the current version of Crate-O is designed for editing self-contained RO-Crates (and works fine with
crates
containing tens of thousands of entities) - our roadmap includes editing fragments of larger linked-data
resources,
and integration with Arkisto repositories such as the Oni repository, data API and search portal.
</p>
<p class="">
Crate-O is currently developed by the <a class="text-blue-600 dark:text-blue-500 hover:underline"
href="https://www.ldaca.edu.au/" target="_blank" rel="noopener noreferrer">Language Data Commons of Australia
(LDaCA)</a>, under the guidance of
Peter Sefton as technical lead. If the tool is adopted in other contexts (we are in talks with a few groups
about this) then we aim to establish a steering committee/reference group to help guide development.
href="ldaca.edu.au" target="_blank" rel="noopener noreferrer"></a><a class="text-blue-600 dark:text-blue-500 hover:underline" href="https://www.ldaca.edu.au/"
target="_blank" rel="noopener noreferrer"></a>
</p>
</div>
</template>
Loading

0 comments on commit b58b9e3

Please sign in to comment.