Skip to content

How to add images, videos and bibliographical reference in the text

Jump to bottom
Stefania Scagliola edited this page Oct 9, 2018 · 26 revisions

Add images:

  1. create a slug in: https://docs.google.com/spreadsheets/d/1kRGo8pfsXjugWRRM3H5T2Ew-sHtGiqDPH0grV74y5MA/edit?usp=sharing

example 1st row - slug: dsc-skill-training

2nd row - title: Phd Skill Training; Exploring the origin and use of the term Digital Source Criticism

3rd row - link: /assets/images/DSC-skill-training.jpg

4th row - start date 2017

5th row - end date 2017

6th row - abstract- this is bla bla

  1. upload image in assets - images

/Users/stefaniascagliola/Desktop/Screen Shot 2018-10-04 at 13.20.02.png

Add slug in the metadata in the list of documents

layout: page lang: en permalink: /define-dsc/ link: /define-dsc/ title: What is Digital Source Criticism documents:

  • dsc-skill-training
  • quelle
  • bothe-zeugnisse-uberlebender-der-shoah
  • delalande-vincent-historien-cyborg
  • hughes-lang-transmutability-decontextualization
  • fickers-towards-digital-historicism-age-abundance
  • hjorland-information-digital-literacy
  • kirschbaum-digital-forensics-cultural-heritage
  • margulies-digitale-geschichtswissenschaft-einfuhrung
  • mounier-ouvrir-atelier-historien
  • owens-digital-sources-digital-archives
  • rheingold-crapp-detection
  • schreiber-genuine-internetdaten-quellen
  • solberg-advances-history-rhetoric
  • sternfeld-understanding-quantum-age
  • terras-digitisation-resources-humanities
  • treleani-recontextualisation-audiovisuels
  • wettlaufer-erkenntnisse-digitalisierte-geschichtswissenschaft-hermeneutischen
  • zaagsma-digital-history

Add code with slug in the place where you want it to appear

[block] (dsc-skill-training)

to make sure the annotation in GitHub connects with the google sheet and appears in the YAML folder, in the file documents, it is necessary to run the bash script on the server that automatically updates the documents

Add Literature

  1. A literature reference should first be added in a google spreadsheet with all its metadata, it should be represented through a slug

fickers-towards-digital-historicism-age-abundance|Towards A New Digital Historicism? Doing History in the Age of Abundance link | http://rdbg.tuxic.nl/euscreen-ojs/index.php/view/article/view/jethc004 |Towards A New Digital Historicism? Doing History in the Age of Abundance |Andreas Fickers | 2012 | 2012

  1. then in the list of documents in the metadata of a page See how this is done in the page 'Defining Digital Source Criticism' first in the metadata:

layout: page lang: en permalink: /define-dsc/ link: /define-dsc/ title: What is Digital Source Criticism documents:

  • dsc-skill-training
  • quelle
  • bothe-zeugnisse-uberlebender-der-shoah
  • delalande-vincent-historien-cyborg
  • hughes-lang-transmutability-decontextualization
  • fickers-towards-digital-historicism-age-abundance
  • hjorland-information-digital-literacy
  • kirschbaum-digital-forensics-cultural-heritage
  • margulies-digitale-geschichtswissenschaft-einfuhrung
  • mounier-ouvrir-atelier-historien
  • owens-digital-sources-digital-archives
  • rheingold-crapp-detection
  • schreiber-genuine-internetdaten-quellen
  • solberg-advances-history-rhetoric
  • sternfeld-understanding-quantum-age
  • terras-digitisation-resources-humanities
  • treleani-recontextualisation-audiovisuels
  • wettlaufer-erkenntnisse-digitalisierte-geschichtswissenschaft-hermeneutischen
  • zaagsma-digital-history

and then in the document:

{: .extra-spacing}

Literature related to the concept of Digital Source Criticism

{: .ml-3.mt-4.mb-2} ref

{: .ml-3.mt-4.mb-2} ref

{: .ml-3.mt-4.mb-2} ref

{: .ml-3.mt-4.mb-2} ref

{: .ml-3.mt-4.mb-2} ref

to make sure the annotation in GitHub connects with the google sheet and appears in the YAML folder, in the file documents, it is necessary to run the bash script on the server that automatically updates the documents

Add clip

  1. first create a slug

tom-tryniski "Amateur Beats Gov't at Digitizing Newspapers: Tom Tryniski's Weird, Wonderful Website " video https://youtu.be/KVWDX6oaYCg 2013

  1. then insert into metadata of document

layout: assignment unit: archival-digital-turn authors:

  • estelle-bunout
  • marten-during lang: en title: "The Digitisation of Newspapers: how to turn a page?" cover: tags:
  • media history
  • web research
  • conversion from analogue to digital requirements: Fast WIFI connection, scissors and paper outcomes:
  • Understand how the process works of selection, digitization and online publishing of newspapers
  • Understand what changes occur when newspapers are turned from paper to digital files
  • Understand what the affordances are of online access to massive amounts of digitized newspapers documents:
  • tom-tryniski order: 6
  1. then insert in the place where you want the clip

Newspapers have become an important media since the 19th century and offer valuable information about events and opinions in our past and present societies. The massive digitization of newspapers, ongoing in many (national) libraries, holds the promise a bonanza of data for historical research. However, in the process of creating online access to digitized newspaper, choices are made and changes occur that affect the informational and artefactual value of a source, and which historians should be able to identify and understand. What appears on your screen at home, is quite different from what you can hold in your hand in the archive. Moreover, National Libraries deal with all kinds of financial, legal and technical constraints, which together with their own institutional history, determine their digitization policy. Some libraries outsource the work of processing and exploiting the data through public-private partnerships with companies. This assignment covers two approaches: 1. You are asked to consider the choices made and technologies used for the digitization and online publication of various newspapers, 2. You will explore the diversity of news covergage and exploit the opportunities of online access to newspapers by conducting comparative research.

card

Instruction

To sensitize you to the subject of digitization of newspapers, watch these clips on two large scale digitization projects, one in the Unites States that discusses all the aspects of the goal of the project and the digitization process: Chronincling America, and one in Europe, Europeana Newspapers that is meant for promotion of the project. Also watch the clip about retired engineer Tom Tryniski, who took up the task of digitizing a gigantic corpus of newspapers and offering them online free of charge.

Then go through the key questions that should be asked when applying source criticism to digitized newspapers:

Selection

  • Why was this collection selected for digitization?
  • Is it complete? Which part of the collection is covered?
  • Is it representative?

Transformation from analogue to digital source

  • How were the newspaper processed? Have all newspapers titles been processed in the same way?
  • What is the appearance of the original newspaper? Are they in black and white or in color? What is the color of the paper? Is this visible on your screen?
  • Was the digitisation carried out from microfilms or from hard copies?
  • What color makes the reading easier in the digital form?
  • How does digitization handle differences between newspapers coming from different periods?

Retrieval

  • Are the newspapers searchable? Can we apply full text search on their content?
  • What is the quality of the Optical Character Recognition process?
  • Has article segmentation been applied? Can we search within advertisements, images ?

to make sure the annotation in GitHub connects with the google sheet and appears in the YAML folder, in the file documents, it is necessary to run the bash script on the server that automatically updates the documents

**TEXT OF DANIELE GUIDO **

The runtime script in the page will cite it appropriately according to the bibliographic reference specified in the google spreadsheet.
To display the document (e.g. an image) in a text, simply

  • get the slug from the table, e.g. delalande-vincent-historien-cyborg
  • add the slug to the documents list in components, units and assignment markdown files (in yaml front matter)

how it looks in a document:

This table is generated by the nodejs script scripts/documents.js that:

  1. import rows from a specific google spreadsheet and. (IN OUR CASE GOOGLE DOC ????)
  2. check for noembed data connected to the document url (WHAT DOES THIS MEAN?)

Each document is identified by a slug and can be referenced in units and assignments contents. Hence we have a unique way of rendering references everywhere in the website.

A quick example

In order to cite the paper Towards A New Digital Historicism? Doing History in the Age of Abundance,

  1. check the corresponding slug in the documents table _data/documents.yaml, you will find: fickers-towards-digital-historicism-age-abundance.

To cite in the text, you simply create a markdown link ref linking to the slug. The runtime script in the page will cite it appropriately according to the bibliographic reference specified in the google spreadsheet.
To display the document (e.g. an image) in a text, simply

  • get the slug from the table, e.g. delalande-vincent-historien-cyborg
  • add the slug to the documents list in components, units and assignment markdown files (in yaml front matter)

Different outputs: simple bibliographic reference or iframe?

If you want to add a reference inside the markdown text, is as easy as adding a markdown link using specific text:

  • [cit](delalande-vincent-historien-cyborg) will be rendered as: (Nicolas Delalande, Julien Vincent, 2011) in the html page, linked to the external url specified in the table, in this case (Nicolas Delalande, Julien Vincent, 2011)

  • [ref](delalande-vincent-historien-cyborg) will be rendered as simple inline reference: Nicolas Delalande, Julien Vincent, Portrait de l''historien-ne en cyborg, 2011 (link)

  • [card](delalande-vincent-historien-cyborg) will be rendered as a block element containing the thumbnail and a few metadata in a form of a "bootstrap card". This option should be used only when we have a thumbnail for that.

Clone this wiki locally