www.jordanschn.com

This website acts as its owner’s personal home on the Web. It is intended to serve both as a place where others can learn more about him and as a platform for him to share his opinions and his ideas with others. Moreover, it also contains a directory of projects he is or has been developing, as well as links to interesting external resources elsewhere on the Web.

The whoami page provides a short biography of the owner and is a good place to start browsing. If your interests overlap with his, you will likely find something here that will pique your curiousity. You are more than welcome to contact him, if you would like to discuss one of the articles or exchange thoughts.

This structure of this repository consists roughly of the following subdirectories and files.

assets/

holds the static content associated with HTML files that are required to properly display and interact with the website. These include fonts, stylesheets and scripts.

content/

holds the plain text source files for generating the corresponding HTML files, along with a other files intended to be downloadable over HTTP(S).

public/

git submodule pointing to a repository to which the published website will be pushed.

vendor/

thid-party files to appear in the published website.

config.el

configuration code for the Org-to-HTML exporter.

This website is built using GNU Emacs and Org-mode’s out-of-the-box publishing capabilities. For RSS export, the ox-rss Emacs package, as listed on the Org-mode Contributed Packages page of the Org-mode website must be installed. There are no other external dependencies, other than the standard POSIX utilities.

Whilst the easiest way to view the website is online, it is also possible to generate the HTML and the associated static files from source, so that these can be viewed locally on your browser. All links on the website are deliberately specified as relative to the current directory, in order to avoid requiring a web server to properly navigate the website offline. As an alternative method of browsing the contents, the Org-mode files under the content/ directory can be visited in Emacs and links will work as expected.

First, clone the repository onto your local machine by running the following command in a shell, such as bash.

git clone 'https://codeberg.org/jordanschn/www.jordanschn.com'

Then, to run the build, simply change to the root directory of the cloned repository and run the following.

make build

The output of the build process will appear in the public/ directory. You can begin browsing by opening the index.html file in your preferred browser.

Normally, files that have not been changed since the last build will be processed. You can force these files to be rebuilt anyways by running make build-force at this step instead of make build.

Jordan Schneider is the owner and maintainer of this website. You can find his contact details are on the whoami page.

If you notice a typo or a factual error in any pages, that will be considered a bug. You can open an issue on this project’s issue tracker to report it. All other commentary should be sent via e-mail to the owner so as to avoid overwhelming the issue tracker with off-topic discussions.

The majority of the content on the website is available under CC BY-SA 4.0. Where content from external authors has been reproduced with permission, appropriate attribution and the licence under which this right was granted will be noted directly in the text itself.

The code for configuring the Org-mode exporter is distributed under the terms of the GNU GPLv3 or later. Other supporting code is also generally also available under the GNU GPLv3 or later, unless noted otherwise. SPDX licence identifiers appear either near the beginning of each file containing source code or in an accompanying file with a .license extension.

You can obtain a copy of all the relevant licence texts under the LICENSES/ directory.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. This file is offered as-is, without any warranty.