installation | Thought splinters

Wayback Machine Tutorial

Sun, 21 Jul 2019 00:00:00 +0000

How to use

Wayback Machine (Slides)

Use the controls on the right bottom of the screen.
Watch out: sometimes there is not only left & right, but also top & down.
Press ALT key (CTRL in Linux) and click on any element to zoom towards it. Click again to zoom back out.
For an overview about the slide structure press ESC.
To end the presentation go back with the browser.

1. Wayback Machine

3. Saving Page (without Outlinks)

4. Saving page (with Outlinks)

5. Captured page

6. Retrieving archived page

Search for archived page

8. Calender view of archived page(s)

9. Collections of archived page(s)

10. Select captures to compare

11. Compare two captures

12. Capture(s) in Site Map view

13. Install browser extension

14. Web page not available

15. Retrieved web page

16. Access personal web archive

17. Personal web archive

Close presentation

Press back button of your browser.

(not back button of the slide!).

LaTeX installieren (Deutsch)

Sun, 07 Jan 2018 00:00:00 +0000

LaTeX installieren

Bedienung dieser Diashow

Steuerungselemente: Pfeile rechts unten
Achtung: Manchmal gibt es außer vor und zurück auch hinauf und hinunter
Folienstruktur-Überblick: ESC-Taste
Zoomen: ALT + (STRG für LINUX) KLICK in das Objekt. Noch ein Klick: Herauszoomen.
Beenden: Mit dem Browser zurück gehen

Voraussetzungen

Bevor wir komfortabel mit R arbeiten können, müssen wir einige Programme installieren

Die aktuelle Version von R
Die aktuelle Version der Entwicklungsumgebung RStudio
Die aktuelle Version von LaTeX

Alle Programme sind Open Source: Sowohl Quellcode als auch Programme sind frei und kostenlos erhältlich.

LaTeX-Installation für Mac (1)

Windows: Pfeil rechts unten nach rechts!

Mac: Weiter mit Pfeil nach unten!

LaTeX-Installation für Mac (2)

LaTeX-Installation für Mac (3)

Präsentation beenden

Sie beenden nun diese Präsentation mit (Browser Pfeil rückwärts)
ACHTUNG: Browser rückwärts – und nicht Folien Pfeil links!

LaTeX-Installation für Windows (1)

LaTeX-Installation für Windows (2)

LaTeX-Installation für Windows (3)

Präsentation beenden

Sie beenden nun diese Präsentation mit (Browser Pfeil rückwärts)
ACHTUNG: Browser rückwärts – und nicht Folien Pfeil links!

RStudio installieren (Deutsch)

Wed, 03 Jan 2018 00:00:00 +0000

Installation von RStudio

Bedienung dieser Diashow

Steuerungselemente: Pfeile rechts unten
Achtung: Manchmal gibt es außer vor und zurück auch hinauf und hinunter
Folienstruktur-Überblick: ESC-Taste
Zoomen: ALT + (STRG für LINUX) KLICK in das Objekt. Noch ein Klick: Herauszoomen.
Beenden: Mit dem Browser zurück gehen

Voraussetzungen

Bevor wir komfortabel mit R arbeiten können, müssen wir einige Programme installieren

Die aktuelle Version von R
Die aktuelle Version der Entwicklungsumgebung RStudio
Die aktuelle Version von LaTeX

Alle Programme sind Open Source: Sowohl Quellcode als auch Programme sind frei und kostenlos erhältlich.

Installation von RStudio

R noch nicht installiert? Beginnen Sie mit diesem Link
Ansonsten rufen Sie die RStudio-Downloadseite auf

Wählen Sie Mac oder Windows-Downlaod

Speichern Sie Ihre Programm-Version

Klicken Sie auf den Download-Link
Speichern Sie die Installationsdatei
Entpacken Sie RStudio
Rufen Sie RStudio dann auf

Es erscheint nun die Entwicklungsumgebung
Klicken Sie in die obere Leiste, damit Sie alle 4 Fensterbereiche sehen

Erkunden Sie Fenster und Reiter von RStudio

Hilfreich ist auch diesen Video
Mehr zu Entwicklungsumgebung dann, wenn wir mit R zu arbeiten beginnen

Zusammenfassung

Es gibt auch YouTube-Videos zum Ansehen
Die Schritte für Mac und Windows sind ähnlich:
z.B. für Mac hier und hier
und für Windows hier und hier
Ein Link, der nochmals alle Schritte zusammenfasst
Sie sollten jetzt R und RStudio installiert haben

Präsentation beenden

Sie beenden nun diese Präsentation mit (Browser Pfeil rückwärts)
ACHTUNG: Browser rückwärts – und nicht Folien Pfeil links!

R installieren (Deutsch)

Tue, 02 Jan 2018 00:00:00 +0000

R installieren

Bedienung dieser Präsentation

Steuerungselemente: Pfeile rechts unten
Achtung: Manchmal gibt es außer vor und zurück auch hinauf und hinunter
Folienstruktur-Überblick: ESC-Taste
Beenden: Mit dem Browser zurück gehen

Voraussetzungen

Bevor wir komfortabel mit R arbeiten können, müssen wir einige Programme installieren

Die aktuelle Version von R
Die aktuelle Version der Entwicklungsumgebung RStudio
Die aktuelle Version von LaTeX

Alle Programme sind Open Source: Sowohl Quellcode als auch Programme sind frei und kostenlos erhältlich.

Neuinstallation von R

Wir beginnen mit der Neu-Installation von R
Und zwar für Mac OS und für Windows

ACHTUNG: Wenn Sie bereits (eine ältere Version von) R installiert haben, dann folgen Sie statt dessen for Windows dieser Anleitung and for Mac dieser Anleitung.

Die R-Startseite

CRAN aufrufen

Wählen Sie Ihre R-Version aus

Mac: Klicken Sie auf Download-Seite für Mac OS X
Windows: gehen Sie zur nächsten Folie (Pfeil rechts)
Weiter für Mac: Pfeil nach unten wählen

1a R-Installation für MacOS X

Klicken Sie auf die neueste R-Version
(hier R-3.4.3.pkg: Stand Januar 2018)

1b Datei .pkg speichern

Es öffnet sich nun ein Fenster
Wählen Sie einen Speicherort
Sichern Sie die Datei

1c R installieren

Öffnen Sie im Betriebssystem die gespeicherte Datei
Es öffnet sich das Installationsprogramm
Befolgen Sie die Anweisungen (“Fortfahren”)

Rufen Sie R auf

Rufen Sie die R.app auf
Geben Sie 2 +2 als Test ein:

Vergleichen Sie Ihr Ergebnis

Beenden Sie Ihre Eingabe mit return
Erscheint [1] 4?
Dann haben Sie R erfolgreich installiert!

Präsentation beenden

Es kann sein, dass der Text Ihrer R-Version leicht unterschiedlich ist. So kann er z.B. komplett in Deutsch geschrieben sein.

Sie beenden nun diese Präsentation mit (Browser Pfeil rückwärts)
ACHTUNG: Browser rückwärts – und nicht Folien Pfeil links!

2. Installiere R für Windows

Gehen Sie auf die Download-Seite für Windows

Download der aktuellen R-Version

R Download für Windows

Windows-Bilschirmfotos gesucht

Ich habe leider keine weiteren Screenshots.

Installieren Sie gerade R für Windows?

Dann schicken Sie mir bitte Screenshots.

Ich baue sie dann in diese Präsentation ein!

Präsentation beenden

Sie beenden nun diese Präsentation mit (Browser Pfeil rückwärts)
ACHTUNG: Browser rückwärts – und nicht Folien Pfeil links!

Install Blogdown (Part 1)

Tue, 19 Sep 2017 00:00:00 +0000

How to use this presentation?

Use the controls on the right bottom of the screen.
Watch out: sometimes there is not only left & right, but also top & down.
Press ALT key (CTRL in Linux) and click on any element to zoom towards it. Click again to zoom back out.
For an overview about the slide structure press ESC.
To end the presentation go back with the browser.

LATEX Installation: Requirements

At first you have to install

R latest version and
RStudio (Preview > v.1.1).

Then start RStudio: You will see the following window…

1. Create new project

2. Choose new directory

3. Select website using blogdown

4. Choose directory name & location

4a Pick your

4b Select theme & get URL

4c Finish form and install

4d Click “Create Project” button

Click “Create Project” Button and wait some seconds. RStudio will install

Hugo
your selected theme and
blogdown with all dependencies

5 Installation is finished!

Close presentation

Press back button of your browser.

(not back button of the slide!).

How to install Disqus on Hugo?

Sun, 10 Sep 2017 00:00:00 +0000

First of all you have to sign up for Disqus.

Create an account on Disqus.

2. Install Disqus

You are offered two choices after the registration process. Select ‘I want to install Disqus on my site’.

Choose ‘Install Disqus’

3. Fill in the form

Disqus needs some information for adding a forum to your website. I will add just two remarks as the form is mostly self-explaining. Firstly, the website name is a text snippet that will appear in the head of every forum section. It does not have to be related to you website name. Secondly, make a note of your Disqus short name as you are going to use it in step 5 and 6.

Configure Disqus for your site

4. Find discussion template

With the next two steps we are going to fix the problem of a faulty Hugo template. Look for the file ‘single.html’ and open it in the editor to inspect the content. single.html should be under /themes/<your-theme-nam>/layouts/_default. At the end of the file – just before the footer –, you should find the name of the partial template for your discussion forum (= ‘comments-html’ in my case).

Configure Disqus for your site.

5. Replace content

Now go and edit this file, which should be found under /themes/<your-theme-nam>/layouts/partials. You have to replace the whole content with the code snippet provided by Yihui Xie (Thanks a lot by the way!!). To help you, you can compare my changes at GitHub. But don’t forget to change the URL to your Disqus account [as I did :blush:]!

Replace content of your partial template as explained

6. Add shortname

To finish the installation you have finally to add the line disqusShortname = "<your-disqus-shortname>" to your config.toml.

Add your Disqus short name into the config.toml

7. Congratulation!

You have integrated Disqus into your static website. Go to one of your posts and check it. Your end of the page should look similar as in the following graphic.

Disqus forum successfully integrated

Critical remark to Disqus

I should mention that there is growing skepticism in the community about Disqus. People are not only criticizing slowness (load-time behavior) but above all they are concerned about data integrity. It seems that there are lots of irrelevant requests to track the data traffic for whatever purpose nobody knows.

Four years later I have changed to utteranc.es.

Blogdown tutorial (Part 2)

Tue, 05 Sep 2017 00:00:00 +0000

Creating a Github repository

Update 2021-05-19: Even if some screenshots might have changed slightly, this part of the tutorial is still up to date. But there are now many other resources with the same content available.

Especially I would like to recommend Up & running with blogdown in 2021 by Allison Hill, co-author of the blogdown book. There is a small part at the end to the integration into GitHub.

R User now can use the helpful package usethis with information how to get Git(Hub) Credentials and with Happy Git and GitHub for the useR there is also a gentle introduction to Git & GitHub.

In part 1 we have installed the hugo-academic theme on top of R, RStudio and blogdown. We will continue the installation process with creating a remote GitHub repository.

Create a GitHub repo

In case you do not have a GitHub account, sign up for it. When you have finished the registration process click the button “Start a project”. If you already have an account click at “New repository”.

Creating a new GitHub repository.

Name your GitHub repo

Both actions (“Start a project” and “New repository”) opens up a window where you can name your new repository. Leave all the other options empty resp. as they are and click the green button “Create repository”.

Name your new GitHub repository.

Quick Setup

The last click brings you to a “Quick setup” page with several options. As there already exist a repository with our hugo-academic files, we copy the two lines in the third option: “push an existing repository from the command line”.

Quick setup: push an exiting repository from the command line.

Shell commands: git init

But before we can paste these two lines into the terminal in order to link our local with the remote GitHub repository we need to download Git and install it. The best description I know of the installation procedure and its integration with RStudio is by Hadley Wickham in chapter 13 of his book about R Packages. There is a online version available. Read the two sections Initial set up and Create a local Git repository. For the mentioned shell commands you can use the Terminal tab of RStudio in the left lower pane.

Use for the shell command the new terminal tab of RStudio.

Git tab in RStudio

5After the shell command git init the local repository is under version control. After you have restarted RStudio you will now see new tabs in the RStudio panes. Click in the Git tab in the upper right pane. This reveals a bunch of folder and some files. The yellow boxes with the question marks under the status column indicate that these file are not yet under version control.

Folders and files which are not under version control.

Add files under version control

To bring these folders and files under version control you have to select all of them and click in one of the check boxes under the column “Staged”. You will see now a lot more files as all the files under the still untracked folders are explicitly shown. The A indicates that these files are new (are just added) to the repository.

New (Added) files to be set under version control.

Initial commit

A click in the Commit tab opens up a new window where you must write a message. This is necessary so that all collaborators (including the future-you!) remembers what was the change about. This first (e.g.initial) commit will bring all the files under version control.

The initial commit brings many files under version control.

Success message

After sending your message by clicking the Commit button you will see a list of all the committed files which are now in the local repository under version control. You can close this window and we can finally add our two lines copied from the GitHub page.

Files are successfully committed.

Connect local with remote repo

Insert the two copied lines from the GitHub repository into the Terminal tab (red arrow). The first line will establish the connection between the local and the remote repository. The second line will push all the committed local files to the GitHub repository.Depending of you internet connection and how many data has to be transferred this can take a couple of seconds (blue arrow).

Connecting local Git with remote GitHub repository and pushing the initial commit.

After this second step we are going to to get a live preview of your website.

Blogdown tutorial (Part 1)

Mon, 04 Sep 2017 00:00:00 +0000

Update 2021-05-19: Even if some screenshots might have changed slightly, this part of the tutorial is – with one exception (header 4) – still up to date. But there are now many other resources with the same content available.

Especially I would like to recommend Up & running with blogdown in 2021 by Allison Hill, co-author of the blogdown book.

In this tutorial I will show how to install the R package blogdown with the help of the new version of RStudio and how to link your local blogdown-directory to a remote repository on GitHub. But before we actually start with the installation procedure let us define the different ingredients (tools) we are going to use:

Tools we are going to use

Blogdown is an R package for creating static websites with R Markdown.
R is an integrated suite of open source software facilities for statistical computing and includes tools for data manipulation, calculation and graphical display.
RStudio is an integrated development environment (IDE) which sits on top of R and facilitates the use of R tremendously.
R Markdown is a file format for making dynamic documents with R. It is based on Markdown (a lightweight markup language with plain text formatting syntax), but it also can contain chunks of embedded R code.
Hugo is a popular open-source static website generator.
hugo-academic is a theme designed for Hugo to create an academic or personal website. Besides special academic features like sections for publications, projects, teaching it also includes a blog section and supports multilingual usage.
GitHub is an Internet hosting service for distributed version control repositories. Is is mainly used for source code management, but it works also with plain text markup languages. GitHub offers all the functionality of Git as well adding its own features.
Git is a distributed version control system for tracking changes in computer files and coordinating work on those files among multiple people.

All these tools are open source and free available.

Preliminary preparations: Installing R and RStudio

There are many tutorials to install R and RStudio. See for instance the video Installing R and RStudio. But at the moment the new version of RStudio which facilitates the installation procedure of blogdown is still not released as standard version. But you can use all these new features by downloading the preview release. As these features will be soon the standard version of RStudio I will explain the installation procedure using this upcoming version.¹

Create a blogdown website

Create a new project

After installing RStudio version greater than v.1.1.28 open the project menu and choose “New Project”.

Create a new project

Create a new directory

A new window opens up: We are going to create a new local directory for our static blogdown website. Choose “New directory”.

Create a new directory

Create a website using blogdown

The selection in the following window is self-explaining: “Website using blogdown”. Here it is the last line in the window. But in the future there may added other project types, so that you have to scroll down to see the blogdown-choice.

Create a website using blogdown

Create a website using Hugo and blogdown

Update 2021-05-19: The Academic theme is now modularized into different specialized templates and integrated into the development of the web builder software wowchemy. To get the complete Academic theme, you have now to write into the Hugo theme field “wowchemy/starter-academic” (instead of “gcushen/hugo-academic”).

Lastly we arrive at the final window we have to answer. Here you can choose the name and location of your local directory which will eventually collect all files of your static website. I recommend to leave all check boxes ticked, as this default value will give you the most support to generate the new website. The program for the static website generator Hugo will be installed automatically as well as sample blog posts will be added. Especially important is the possibility to look into the example site of the theme, because this will provide you with clues about the functionality of the theme.

Create a website using Hugo and blogdown

Choose theme

I have chosen the hugo-academic theme. You can pick your own preferred webdesign via the Hugo Themes page.

Huge variety of Hugo themes to choose from.

Choose Academic (now Wowchemy)

In the “Hugo theme” field you have to insert the URL of the GitHub repository of the theme you would like to use. You will see the address when you click at the thumbnail of the theme and hover your cursor over the “Download”-button.

hugo-academic is as special theme for personal websites in academia.

GitHub repor of Academic theme

Clicking on the download button will bring up the developer’s repository. This is useful even for beginner as you can have a look of the ongoing discussion under the “issue” tab or to ask your own questions. Experienced users can fork the repository in order to adapt the functionality of the theme and/or to suggest code changes to the developer via the push mechanism.

GitHub code repository of the hugo-academic theme.

Create project

When you finally click the “Create Project” button you have to wait few seconds until the selected theme is downloaded and Hugo installed. After the installation is finished RStudio opens up a four pane view. We will go more into the details of these different windows in the third part of this tutorial.

RStudio’s four pane view immediately after installation.

Summary

We have successfully installed the hugo-academic theme in a version controlled local directory. Essentially we could now start to personalize the website and/or write articles resp. posts. But we will continue the installation process with creating a remote GitHub repository which has to be linked to the just created local repository. The remote repository not only operates as backup and as distributed version control (allowing collaboration) but also enables – beside a manual transfer via ftp – additional ways of publishing your website. We will cover these possibilities in the following parts of this tutorial.

Go and visit the second part Creating a GitHub Repository of this tutorial.

To use features supporting blogdown websites the RStudio version has to be higher than v1.1.28: As today (2017-09-04) the actual preview version is v1.1.353. ↩︎

installation | Thought splinters

Wayback Machine Tutorial

Wayback Machine (Slides)

Start Page

Save Page Now

3. Saving Page (without Outlinks)

4. Saving page (with Outlinks)

5. Captured page

6. Retrieving archived page

Search for archived page

8. Calender view of archived page(s)

9. Collections of archived page(s)

10. Select captures to compare

11. Compare two captures

12. Capture(s) in Site Map view

13. Install browser extension

14. Web page not available

15. Retrieved web page

16. Access personal web archive

17. Personal web archive

Close presentation

LaTeX installieren (Deutsch)

LaTeX installieren

Voraussetzungen

LaTeX-Installation für Mac (1)

LaTeX-Installation für Mac (2)

LaTeX-Installation für Mac (3)

Präsentation beenden

LaTeX-Installation für Windows (1)

LaTeX-Installation für Windows (2)

LaTeX-Installation für Windows (3)

Präsentation beenden

RStudio installieren (Deutsch)

Installation von RStudio

Voraussetzungen

Installation von RStudio

Wählen Sie Mac oder Windows-Downlaod

Speichern Sie Ihre Programm-Version

Zusammenfassung

Präsentation beenden

R installieren (Deutsch)

R installieren

Voraussetzungen

Neuinstallation von R

CRAN aufrufen

Wählen Sie Ihre R-Version aus

1a R-Installation für MacOS X

1b Datei .pkg speichern

1c R installieren

Rufen Sie R auf

Vergleichen Sie Ihr Ergebnis

Präsentation beenden

2. Installiere R für Windows

Download der aktuellen R-Version

Windows-Bilschirmfotos gesucht

Präsentation beenden

Install Blogdown (Part 1)

How to use this presentation?

LATEX Installation: Requirements

1. Create new project

2. Choose new directory

3. Select website using blogdown

4. Choose directory name & location

preferred theme

4b Select theme & get URL

4c Finish form and install

4d Click “Create Project” button

5 Installation is finished!

Close presentation

How to install Disqus on Hugo?

1. Sign up

2. Install Disqus

3. Fill in the form

4. Find discussion template

5. Replace content

6. Add shortname

7. Congratulation!

Critical remark to Disqus

Blogdown tutorial (Part 2)

Creating a Github repository