Skip to content

Commit

Permalink
✨ Initial commmit, yay!
Browse files Browse the repository at this point in the history
  • Loading branch information
silencesys committed Jan 28, 2024
0 parents commit 03a98e2
Show file tree
Hide file tree
Showing 7 changed files with 734 additions and 0 deletions.
21 changes: 21 additions & 0 deletions LICENSE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2024 Martin Roček

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
37 changes: 37 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# Tiny template for TEI editions

Have you ever run a workshop on TEI and then struggled with where or how to publish the students' work? This template was created for that very reason. It has been designed to be as simple as possible, while still allowing students to make at least some adjustments so that they feel a sense of ownership over their work.

## Limitations
- It does not work with images
- It does not work with multiple files
- It does not work very well with different readings

However in future versions I hope to address these issues and extend the functionality of the template. If you have any suggestions, please let me know.

## How to use this template
1. You can either fork this repository or download it as a zip file in the release section.
2. Copy your XML edition to the `xml` folder.
3. Edit the `index.html` file to include the correct path to your XML file. Look for following line
```html
<script>
var CETEIcean = new CETEI()
CETEIcean.getHTML5("xml/[name_of_your_file].xml", function(data) {
document.getElementById("TEI").appendChild(data)
})
</script>
```
4. You can tweak colour, text-size etc. in the `config.css` file at the root of the repository.
5. Publish it on GitHub pages or any other web-server.

## Publishing on GitHub pages
1. Create a new repository on GitHub.
2. Upload the files from the template to the repository.
3. Go to the settings of the repository and scroll down to the GitHub pages section.
4. Select the `master` branch as the source and click save.
5. Wait a few minutes and then click on the link provided in the GitHub pages section.

## Copyright and licence
This template is released under the [MIT licence](LICENSE.md) and is free to use, modify and redistribute. The example XML file should be considered as a demonstration of the template and is not covered by the licence.

This template uses the [CETEIcean](https://github.com/TEIC/CETEIcean) library, which is released under the [BSD 2-Clause "Simplified" License](https://github.com/TEIC/CETEIcean/blob/master/LICENSE.md).
1 change: 1 addition & 0 deletions assets/CETEI.js

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

Loading

0 comments on commit 03a98e2

Please sign in to comment.