You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

235 lines
9.0 KiB
HTML

4 years ago
<!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&amp;action=edit&amp;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
&lt;https://pad.xpub.nl/p/Notes_on_texts&gt;
## bootleg library
+ &lt;https://hub.xpub.nl/bootleglibrary&gt;
User: THENWHO
Password: WASPHONE
### we will use:
* calibre-web, the software the bootleg library runs on
&lt;https://github.com/janeczku/calibre-web&gt;
* Etherpad, a browser-based, realtime collaborative text editor
&lt;https://pad.xpub.nl&gt;
* Markdown, a lightweight markup language
&lt;https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet&gt;
&lt;https://daringfireball.net/projects/markdown/syntax&gt;
* Pandoc, a universal document converter
&lt;https://pandoc.org/&gt;
Installation guide:
&lt;https://pandoc.org/installing.html&gt;
### workflow summary:
**1. upload to the bootleg library**&lt;br /&gt;
**2. select a PDF, choose a page from that text**&lt;br /&gt;
**3. annotate the page in a new etherpad document (use markdown for structure)**&lt;br /&gt;
**4. export to plain text from etherpad**&lt;br /&gt;
**5. convert .txt to .EPUB**&lt;br /&gt;
**6. upload to the bootleg library**&lt;br /&gt;
**7. paste URL of the pad you used**&lt;br /&gt;
### 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....
&lt;https://hub.xpub.nl/bootleglibrary/read/382/pdf&gt;
* 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)
&lt;https://hub.xpub.nl/bootleglibrary/read/382/pdf#page=17&gt;
**3. annotate the page in a new etherpad document (use markdown for structure)**
* Make a new etherpad document* using &lt;https://pad.xpub.nl&gt;, 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
&lt;code&gt;
---
title: Annotations on Exercises In Style
author: collaborative/Etherpad
date: 21/05/20
---
&lt;/code&gt;
* Write your annotations, use markdown* if possible
Cheatsheet available here: &lt;https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet&gt;
### 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
&lt;https://hub.xpub.nl/bootleglibrary&gt;
* Headings can be added like this:
# h1
## h2
### h3
and so on...
* Emphasis can be added with &lt;code&gt;*single asterisks*&lt;/code&gt;, bold with &lt;code&gt;**double asterisks**&lt;/code&gt;
* Add a heading, and the URL to the pdf, before exporting, for example
&lt;code&gt;
# Annotations on *Notation*
[page 17](https://hub.xpub.nl/bootleglibrary/read/382/pdf#page=17)
&lt;/code&gt;
**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)
&lt;code&gt;
pandoc --from markdown --to epub my_etherpad.txt -o annotations.epub
&lt;/code&gt;
**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
&lt;https://linux.die.net/man/1/pdftk&gt; (tool: stamp)
&lt;https://beepb00p.xyz/annotating.html&gt; (annotating the web)
&lt;https://hypothes.is/&gt;&lt;br /&gt;
&lt;https://pzwiki.wdka.nl/mediadesign/User:Angeliki/X-LIB/Annotations&gt;&lt;br /&gt;
&lt;https://pzwiki.wdka.nl/mediadesign/File:Annotated_stein.jpg&gt;&lt;br /&gt;
## other references
House of Leaves, Danielewski
&lt;https://www.katjarempel.de/project/ebookdossier.html&gt;
&lt;http://www.kajsadahlberg.com/work/a-room-of-ones-own--a-thousand-libraries/&gt;
</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
Postexpand 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 postexpand 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>