|
|
<!DOCTYPE html>
|
|
|
<!DOCTYPE html>
|
|
|
<html>
|
|
|
<head>
|
|
|
<meta charset="utf-8">
|
|
|
<title>Tasks of the Contingent Librarian</title>
|
|
|
<link rel="stylesheet" type="text/css" href="tasks.css">
|
|
|
<script src="tasks.js"></script>
|
|
|
</head>
|
|
|
<body>
|
|
|
|
|
|
<div class="cardback"><DOCUMENT_FRAGMENT><div class="mw-parser-output"><div class="thumb tright"><div class="thumbinner" style="width:152px;"><a class="image" href="https://pzwiki.wdka.nl/mw-mediadesign/images/thumb/0/0d/Deadheads.jpeg/960px-Deadheads.jpeg"><img alt="" class="thumbimage" decoding="async" src="https://pzwiki.wdka.nl/mw-mediadesign/images/thumb/0/0d/Deadheads.jpeg/320px-Deadheads.jpeg"></a> <div class="thumbcaption"><div class="magnify"><a class="internal" href="File:Deadheads.jpeg.html" title="Enlarge"></a></div>“Deadheads” recording a live Grateful Dead concert, 1972</div></div></div>
|
|
|
<h2><span id="workflow_for_Notes_on_Texts,_a_session_that_annotates_a_collection"></span><span class="mw-headline" id="workflow_for_Notes_on_Texts.2C_a_session_that_annotates_a_collection">workflow for <i>Notes on Texts</i>, a session that annotates a collection</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/mw-mediadesign/index.php?title=User:Simon/Notes_on_texts_workflow&action=edit&section=T-1" title="Edit section: ">edit</a><span class="mw-editsection-bracket">]</span></span></h2>
|
|
|
<p>Documentation in markdown, from a pad. This allows an EPUB to be made from an exported txt by running it through <code>pandoc</code>. Most important is the first four lines - to make an EPUB you need to have metadata for at least the title and author, which was interesting to consider when making annotations on a text. Who retains authorship? Who claims it?
|
|
|
</p><p>Some screenshots from the session:
|
|
|
</p>
|
|
|
<ul class="gallery mw-gallery-traditional">
|
|
|
<li class="gallerybox" style="width: 155px"><div style="width: 155px">
|
|
|
<div class="thumb" style="width: 150px;"><div style="margin:38.5px auto;"><a class="image" href="https://pzwiki.wdka.nl/mw-mediadesign/images/thumb/0/06/Annotations_on_Entreprecariat_01.png/960px-Annotations_on_Entreprecariat_01.png"><img alt="" decoding="async" src="https://pzwiki.wdka.nl/mw-mediadesign/images/thumb/0/06/Annotations_on_Entreprecariat_01.png/320px-Annotations_on_Entreprecariat_01.png"></a></div></div>
|
|
|
<div class="gallerytext">
|
|
|
<p>The book we chose to annotate
|
|
|
</p>
|
|
|
</div>
|
|
|
</div></li>
|
|
|
<li class="gallerybox" style="width: 155px"><div style="width: 155px">
|
|
|
<div class="thumb" style="width: 150px;"><div style="margin:38.5px auto;"><a class="image" href="https://pzwiki.wdka.nl/mw-mediadesign/images/thumb/6/6a/Annotations_on_Entreprecariat_02.png/960px-Annotations_on_Entreprecariat_02.png"><img alt="" decoding="async" src="https://pzwiki.wdka.nl/mw-mediadesign/images/thumb/6/6a/Annotations_on_Entreprecariat_02.png/320px-Annotations_on_Entreprecariat_02.png"></a></div></div>
|
|
|
<div class="gallerytext">
|
|
|
<p>The EPUB we produced in the bootleg library
|
|
|
</p>
|
|
|
</div>
|
|
|
</div></li>
|
|
|
<li class="gallerybox" style="width: 155px"><div style="width: 155px">
|
|
|
<div class="thumb" style="width: 150px;"><div style="margin:38.5px auto;"><a class="image" href="https://pzwiki.wdka.nl/mw-mediadesign/images/thumb/c/cd/Annotations_on_Entreprecariat_03.png/960px-Annotations_on_Entreprecariat_03.png"><img alt="" decoding="async" src="https://pzwiki.wdka.nl/mw-mediadesign/images/thumb/c/cd/Annotations_on_Entreprecariat_03.png/320px-Annotations_on_Entreprecariat_03.png"></a></div></div>
|
|
|
<div class="gallerytext">
|
|
|
<p>Our annotations on a pad
|
|
|
</p>
|
|
|
</div>
|
|
|
</div></li>
|
|
|
</ul>
|
|
|
<pre>---
|
|
|
title: notes on texts
|
|
|
author: collective/Etherpad
|
|
|
---
|
|
|
|
|
|
Notes on *Notes on Texts*, with Simon Browne, contingent librarian* at the bootleg library*
|
|
|
|
|
|
## url to this editable pad
|
|
|
<https://pad.xpub.nl/p/Notes_on_texts>
|
|
|
|
|
|
## bootleg library
|
|
|
+ <https://hub.xpub.nl/bootleglibrary>
|
|
|
User: THENWHO
|
|
|
Password: WASPHONE
|
|
|
|
|
|
### we will use:
|
|
|
* calibre-web, the software the bootleg library runs on
|
|
|
<https://github.com/janeczku/calibre-web>
|
|
|
|
|
|
* Etherpad, a browser-based, realtime collaborative text editor
|
|
|
<https://pad.xpub.nl>
|
|
|
|
|
|
* Markdown, a lightweight markup language
|
|
|
<https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet>
|
|
|
<https://daringfireball.net/projects/markdown/syntax>
|
|
|
|
|
|
* Pandoc, a universal document converter
|
|
|
<https://pandoc.org/>
|
|
|
Installation guide:
|
|
|
<https://pandoc.org/installing.html>
|
|
|
|
|
|
### workflow summary:
|
|
|
|
|
|
**1. upload to the bootleg library**<br />
|
|
|
**2. select a PDF, choose a page from that text**<br />
|
|
|
**3. annotate the page in a new etherpad document (use markdown for structure)**<br />
|
|
|
**4. export to plain text from etherpad**<br />
|
|
|
**5. convert .txt to .EPUB**<br />
|
|
|
**6. upload to the bootleg library**<br />
|
|
|
**7. paste URL of the pad you used**<br />
|
|
|
|
|
|
### workflow steps in detail:
|
|
|
|
|
|
**1. upload to the bootleg library**
|
|
|
|
|
|
* Click 'upload'
|
|
|
* Choose a text from your computer
|
|
|
* Enter metadata, or download it
|
|
|
* Click 'submit'
|
|
|
|
|
|
|
|
|
**2. select a PDF, choose a page from that text**
|
|
|
|
|
|
* Click on a catalogue entry to see the book details
|
|
|
* Click on 'read in browser', choose 'pdf'
|
|
|
* Part of what calibre web does is create URLs for each book in the library, for instance, Raymond Queneau, Exercises in Style is now referenceable as....
|
|
|
|
|
|
<https://hub.xpub.nl/bootleglibrary/read/382/pdf>
|
|
|
|
|
|
* Scroll to a page in the browser e-reader
|
|
|
* Add an anchor to the URL with #page=17 (this will load the URL at pg 17)
|
|
|
|
|
|
<https://hub.xpub.nl/bootleglibrary/read/382/pdf#page=17>
|
|
|
|
|
|
|
|
|
**3. annotate the page in a new etherpad document (use markdown for structure)**
|
|
|
|
|
|
* Make a new etherpad document* using <https://pad.xpub.nl>, name it anything you want
|
|
|
* Add details for title and author following the example below. The title and author can be anything you want, but this metadata is required to make an EPUB, so make sure you enter something
|
|
|
|
|
|
<code>
|
|
|
---
|
|
|
title: Annotations on Exercises In Style
|
|
|
author: collaborative/Etherpad
|
|
|
date: 21/05/20
|
|
|
---
|
|
|
</code>
|
|
|
|
|
|
* Write your annotations, use markdown* if possible
|
|
|
|
|
|
Cheatsheet available here: <https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet>
|
|
|
|
|
|
### Quick Markdown guide
|
|
|
|
|
|
* You can add URLs as hyperlinked text, for example with
|
|
|
|
|
|
[Label text here](https://hub.xpub.nl/bootleglibrary)
|
|
|
|
|
|
or
|
|
|
|
|
|
* You can also add a URL like this
|
|
|
|
|
|
<https://hub.xpub.nl/bootleglibrary>
|
|
|
|
|
|
|
|
|
* Headings can be added like this:
|
|
|
|
|
|
|
|
|
# h1
|
|
|
|
|
|
## h2
|
|
|
|
|
|
### h3
|
|
|
|
|
|
|
|
|
and so on...
|
|
|
|
|
|
|
|
|
* Emphasis can be added with <code>*single asterisks*</code>, bold with <code>**double asterisks**</code>
|
|
|
|
|
|
|
|
|
* Add a heading, and the URL to the pdf, before exporting, for example
|
|
|
|
|
|
<code>
|
|
|
# Annotations on *Notation*
|
|
|
|
|
|
[page 17](https://hub.xpub.nl/bootleglibrary/read/382/pdf#page=17)
|
|
|
</code>
|
|
|
|
|
|
**4. export to plain text from etherpad**
|
|
|
|
|
|
* Click on the 'Import/Export from/to different file formats' option
|
|
|
* Export current pad as: 'plain text' (the file will be saved as a .txt, and named after the pad)
|
|
|
|
|
|
|
|
|
**5. convert .txt to .EPUB**
|
|
|
|
|
|
* Using pandoc*, run this command in the terminal (swap out the file names)
|
|
|
|
|
|
<code>
|
|
|
pandoc --from markdown --to epub my_etherpad.txt -o annotations.epub
|
|
|
</code>
|
|
|
|
|
|
|
|
|
**6. upload to the bootleg library**
|
|
|
|
|
|
* Click on the book you annotated to see the book details
|
|
|
* Click on 'Edit metadata'
|
|
|
* Scroll down, click on 'Upload Format'
|
|
|
* Upload the EPUB you made to the same catalogue entry
|
|
|
|
|
|
**7. paste URL of the pad you used:**
|
|
|
|
|
|
https://pad.xpub.nl/p/exercises_in_style_annotations
|
|
|
https://pad.xpub.nl/p/entreprecariat_annotations
|
|
|
https://pad.xpub.nl/p/Annotations_On_The_End_of_Policing
|
|
|
|
|
|
|
|
|
|
|
|
## other tools for annotation
|
|
|
<https://linux.die.net/man/1/pdftk> (tool: stamp)
|
|
|
|
|
|
<https://beepb00p.xyz/annotating.html> (annotating the web)
|
|
|
|
|
|
<https://hypothes.is/><br />
|
|
|
<https://pzwiki.wdka.nl/mediadesign/User:Angeliki/X-LIB/Annotations><br />
|
|
|
<https://pzwiki.wdka.nl/mediadesign/File:Annotated_stein.jpg><br />
|
|
|
|
|
|
|
|
|
## other references
|
|
|
|
|
|
House of Leaves, Danielewski
|
|
|
|
|
|
<https://www.katjarempel.de/project/ebookdossier.html>
|
|
|
|
|
|
<http://www.kajsadahlberg.com/work/a-room-of-ones-own--a-thousand-libraries/>
|
|
|
</pre>
|
|
|
<!--
|
|
|
NewPP limit report
|
|
|
Cached time: 20200620143614
|
|
|
Cache expiry: 86400
|
|
|
Dynamic content: false
|
|
|
CPU time usage: 0.032 seconds
|
|
|
Real time usage: 0.045 seconds
|
|
|
Preprocessor visited node count: 13/1000000
|
|
|
Preprocessor generated node count: 48/1000000
|
|
|
Post‐expand include size: 562/2097152 bytes
|
|
|
Template argument size: 0/2097152 bytes
|
|
|
Highest expansion depth: 2/40
|
|
|
Expensive parser function count: 0/100
|
|
|
Unstrip recursion depth: 0/20
|
|
|
Unstrip post‐expand size: 7014/5000000 bytes
|
|
|
-->
|
|
|
<!--
|
|
|
Transclusion expansion time report (%,ms,calls,template)
|
|
|
100.00% 34.706 1 User:Simon/Notes_on_texts_workflow
|
|
|
100.00% 34.706 1 -total
|
|
|
-->
|
|
|
|
|
|
<!-- Saved in parser cache with key wdka_mw_mediadesign-mw_:pcache:idhash:31698-0!canonical and timestamp 20200620143614 and revision id 175189
|
|
|
-->
|
|
|
</div></DOCUMENT_FRAGMENT></div>
|
|
|
|
|
|
</body>
|
|
|
</html>
|