Personal website https://2martens.de
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Gitea 0472e5a0e3 Calendar synchronization at Tue 20 Oct 22:00:29 UTC 2020 14 hours ago
.github Create dependabot.yml 3 months ago
_assets Improved navigation with anchors 1 year ago
_data Disable notification 3 months ago
_drafts Added draft article 6 months ago
_events Calendar synchronization at Tue 20 Oct 22:00:29 UTC 2020 14 hours ago
_includes Fixed logical operator 3 months ago
_layouts Fixed position of back-to-top button on pages without sidebar 1 year ago
_posts Added post about corona, cars and terror 3 months ago
assets Added master thesis to website 6 months ago
blog Fixed issue with string screwing up HTML 2 years ago
cs Provided custom meta descriptions for each page and post 2 years ago
district Daten aktualisiert 1 year ago
pages Added two articles to reading list 3 months ago
politics Provided custom meta descriptions for each page and post 2 years ago
scripts Fixed deploy script 2 years ago
software-craftsman Added category and pages related to software craftsmanship 3 months ago
speeches Provided custom meta descriptions for each page and post 2 years ago
.drone.yml Added pipeline type for drone config 3 months ago
.eslintrc Added browser and jquery global variables to eslint environment 1 year ago
.gitignore Added node_modules to gitignore 2 years ago
.htaccess Updated path for allris-eimsbüttel 4 months ago
.travis.yml Ensures only pushes to master branch are built 2 years ago
Gemfile Merge pull request #27 from 2martens/dependabot/bundler/rubyzip-2.3.0 3 months ago
Gemfile.lock Merge pull request #77 from 2martens/dependabot/bundler/jekyll-feed-0.15.1 1 week ago
LICENSE Added missing space that should make GitHub pick up Apache 2.0 license 2 years ago
README.md Added updated build status badge 1 year ago
_config.test.yml Added config for test builds 1 year ago
_config.yml Added missing config for github metadata 3 months ago
counter Calendar synchronization at Tue 20 Oct 22:00:29 UTC 2020 14 hours ago
deploy_ed25519.enc Added travis CI 2 years ago
feed.xml Switched to jekyll assets 2 years ago
google98936b4605d7df21.html [Global] Added google site verification 4 years ago
gulpfile.js Upgraded dependencies 3 months ago
index.html Added missing reading-optimised class to index 1 year ago
package.json Bump del from 5.1.0 to 6.0.0 3 weeks ago
robots.txt Allow entire site for robots 2 years ago
yarn.lock Bump del from 5.1.0 to 6.0.0 3 weeks ago

README.md

Personal Website

Build Status Website Status

This repository hosts my personal website. It is jekyll powered with all required dependencies described in the Gemfile. If you wanted, you could create the very same website with this repository that you can find under the official URL.

You can use it as a starting point for your own website. In the following I will describe what you need to change to make it your own (minimal changes).

Guest posts

If you want to contribute a post, feel free to submit a pull request with a post. Make sure to add the value “author” with your name.

Customization

  • _config.yml: this contains the site configuration, update it to meet your needs
  • _data/: this directory contains data files that allow for easy website changes
  • _data/author.yml: this file describes the key values for the author (website owner), the values are also used to populate the CV page and the author sidebar box
  • _data/footer-menu.yml: defines the footer menu
  • _data/header-menu.yml: defines the header menu
  • _data/notification.yml: defines the global configuration and if it is visible
  • _data/promotion.yml: defines the promotion and if it is visible
  • _data/cdn.yml: defines whether a CDN is used and what it’s URL is
  • _data/lazy-loading.yml: defines whether images are loaded lazily
  • assets/: required static files
  • assets/images/uberspace-badge-*.png: must be changed to accomodate your promotional image
  • assets/images/brand.svg: must be changed to your brand image
  • assets/pdf/cv.pdf: change for your CV in PDF format
  • _posts/: delete and write your own posts
  • _includes/: no need to touch, nothing hard-coded inside
  • _includes/sidebar/: contains available sidebar boxes, add files here and then you can already use the new sidebar box
  • pages/: directory for pages, don’t forget permalink variable for new pages, update every page but 404.html and cv.html to your situation
  • index.html: you should probably update the text here
  • .htaccess: remove the part that rewrites jim.2martens.de to 2martens.de

Beyond this no changes are absolutely necessary. No links are hard-coded in the pages, layouts or include files beyond the technical dependencies.

The sidebar is configured via variables in the YAML front matter. By default the author sidebar box is shown everywhere. You can customize this by adding the variable sidebarboxes to the front matter of a post, page or category. Then specify all boxes you want to use by their file name without the extension in the order they should appear separated by a whitespace each. Look into existing pages for examples.

Without any new files other than posts, these categories are supported out of the box:

  • speeches (appears under Speeches menu point)
  • politics (appear under Politics menu point)
  • politics G20 (appears both under Politics and Politics/G20 menu points)
  • cs (appears under Computer Science menu point)
  • blog (appears under Blog menu point)
  • site (appears on home page)

Responsive images

If you want to include responsive images in posts, use the following:

{% include image.html alt="<your alt text>" link="<the relative link to the image>" %}

If you have enabled a CDN and are in a production environment (JEKYLL_ENV set to production) the URL of the image will use the CDN. Otherwise it will be relative to the root directory of the website. The advantage in this approach is quite obvious. If you want to change the HTML of an image, you just need to change the image.html and the link to a potential CDN only has to be changed in one location and not in potentially thousands of img tags or the markdown equivalent. The HTML provided by image.html automatically adds “img-fluid” to all images which makes them responsive by using Bootstrap.

Continuous Integration and Deployment

The .travis.yml file is already in a good state to use it for own needs. But you need to update it to make it work for you. In the following I will list the absolute minimal changes you need to do.

  • scripts/deploy.sh: change martens7 to your Uberspace user and wolf.uberspace.de to your host
  • .travis.yml: update the known hosts for your Uberspace host, update the before_deploy section (first dash)
  • deploy_ed25519.enc: change to your encrypted SSH key

To understand how to prepare the SSH connection, follow this link: https://oncletom.io/2016/travis-ssh-deploy/