Nagymaros is a Jekyll theme designed for conferences, workshops, meetings, and similar events. It has a simple and intuitive structure featuring four pages that provide key information about the event:
- An index, meant for basic details and links to external sources, such as submission systems.
- A program, allowing for single or multi-day schedules and color-coded event categories.
- A map of conference locations, customizable with markers, areas, and tooltips.
- An alphabetical list of contributors, with optional roles and email addresses.
The theme is based on Bootstrap 5, which makes it mobile-first and fully responsive. Body text is set in Inter, a clean sans-serif typeface that guarantees readability at small screen sizes. A slab-serif typeface, Zilla Slab, is used instead in display headings. The layout is adapted from jekyll-conference-theme and remains quite similar to it, but compared to this theme, Nagymaros aims to be simpler and easier to customize.
See the demo to find out what the theme looks like.
The theme can be installed as usual by cloning this repository and editing the files. However, it is far more convenient to install it as a gem, in which case all the files you do not want or need to customize remain hidden from view, but will still be read and processed during build.
If you choose to install the theme as a gem, your site should include at a minimum the following files:
.
├── 404.md
├── _config.yml
├── contributors.md
├── _data
│ ├── contributors.yml
│ ├── index.yml
│ ├── locations.yml
│ └── program.yml
├── Gemfile
├── index.md
├── locations.md
└── program.md
To install the theme, you can then add this line to your Gemfile:
gem "jekyll-nagymaros"And this line to _config.yml:
theme: jekyll-nagymarosThe easiest way to set up a new website in this way is to clone the contents of the demo folder. This provides a working set of files to get you started.
After you are done creating the basic files, run bundler:
$ bundle
Or install the gem yourself as:
$ gem install jekyll-nagymaros
To customize hidden files, you can create new files with the same names and paths. For example, to change the layout of the index page, you can create a _layouts folder and a file index.html within this folder that contains your custom code. During build, Jekyll will give priority to your files over the theme's.
Core customization occurs in _config.yml. Aside from the usual configuration variables, you can set a value for the variable home, which specifies the page of your site to which you want the home button in the navigation bar to redirect. By default, this is set to the index. In addition, you can set a value for copyright, which corresponds to the name of the copyright holder in the notice within the theme's footer. By default, no value is provided for this variable, in which case the whole copyright notice is suppressed. Finally, you can set a value for indexing, which tells search engine crawlers whether to index your site. By default, the value is false, in which case the following code is placed in the head of every page:
<meta name="robots" content="noindex, nofollow">If you set indexing: true, however, crawlers will be allowed to index your site and Jekyll will populate the head of every page with SEO tags through the jekyll-seo-tag plugin.
Data that appears in the theme's four default pages must be configured via YAML files located in the _data folder. See the corresponding files in demo/_data to understand how to write your own YAML, or better yet, clone these files and edit them.
The order of appearance of pages in the theme's navigation bar is determined by the value of navorder set in each page's front matter. For example, setting navorder: 1 will make the page appear first in the list. Note that a page will only appear in the navigation bar if the navorder variable is set, so it is possible to hide some pages from navigation simply by not giving this variable a value.
Customizing the CSS is possible by creating a file _sass/_custom.scss. You can use this both to define new styles or to overwrite the theme's defaults. The file will be automatically compiled during build.
The theme builds on the following projects:
If you find any problem using this theme, please open an issue.