After the Summer School

After the summer school there are a few things that you could do:

Update the website and/or send us files/texts to do so

We think that throughout the week we have collected a wealth of material on various matters around prosopographical research. If you have any more material/data/insights you want to share, please go ahead and do so via the website. For adding texts to the website yourself you can either use Markdown or Restructured Text directly. If you use one or the other please do not forget to set the correct file ending (.md or .rst), so the site builder knows how to compile it. If you add a new file, you need also to add it to /index.rst in the ToC section (or in a ToC section somewhere else). You can of course also just add to already existing files.

Please note: Git is a versioning system, it allows to roll back any changes you make. So please don’t be afraid to break anything!

Run through the notebooks and experiment with changing the code

We are aware that the code in the interactive notebooks is sometimes complex and probably scared away people from learning to code (at least a little). However, we also believe the easiest way of learning things is by just doing them. So we encourage everyone to run through the cells in the notebooks and experiement with changing values and routines. Again the notebooks are checked in in git and you can always go back to the original state.

There are basically two ways of executing the notebooks:

  1. Install Python and/or R (for the SNA notebook) on your local machine:

Depending on your operating system installing Python and/or R is a bit different. If you are on Windows, the easiest way of installing Python and R is using Anaconda (actually Anaconda can be used for all operating systems). For Mac there is also the possibility to install it through a package management system like (Home)brew. In Linux it depends on your distribution, but most of the distributions have Python already installed.

If you have installed Python, open up a terminal and do the following:

cd /path/to/repo
pip install virtualenv
virtualenv yourvenv
source yourvenv/bin/activate
pip install -r requirements.txt
jupyter notebook

After the last command, a Jupyter server should start. Head over to your browser and open the notebook.

  1. Update the repo you forked from acdh-oeaw/summer2020-notebooks:

either by filing a pull request (at your forked version), changing the compare direction and finally merging the pull request, or by just deleting your forked repo and forking it again. After you have an up-to-date forked repo, head to Google Colab and run the notebooks (in the “open notebook” dialog there is a tab called ‘GitHub’)

Add material and/or papers to the website

We started collecting additional material that could be interesting for some of us here Resources. If you have any links to tools, interesting papers or useful Howtos please add them there.

If you want to upload material please do so in the /files folder or – if you plan on directly embedding the resource (e.g. video or pdf) in the website, like we did with the student presentations – in the /_static folder. Examples on how to use HTML5 tags to embed videos and pdfs can be found here /documentation/student_presentations.rst.

We also added a bibliography <documentation/bibliography to the website. Unfortunately it currently is still a mess, but we will work on removing items of lesser interest. If you want to add to the bibliography, please add the bibtex of the entries you want to add to the /bibliography.bib file in the repo. If you are working with a citation software such as Zotero, obtaining the bibtex is very easy: highlight the entries you want to export >> right click >> and choose ‘export’ in the context menu. Select ‘Bibtex’ as export format and store the file somewhere. Open the file in a text editor and copy everything to /bibliography.bib.