NAACL-HLT 2019 official website
This is the code for the official website for the 2019 Annual Conference of the North American Chapter of the Association for Computational Linguistics: Human Language Technologies (NAACL-HLT).
It's currently using the Minimal Mistakes Jekyll Theme.
You can test this website locally on macOS as follows:
- Install bundler:
sudo gem install bundler. Make sure you have Ruby and Bundler versions > 2.4.
- Clone this repository. Note that this repository uses submodules so to properly check out the submodule code, run
git submodule initand
git submodule updateafter you clone the repository. You will need the submodule to generate the schedule for the website.
- Run the gems needed by this repository:
sudo bundle install. Note: This step might fail when installing the
nokogirigem. If this happens, run
bundle config build.nokogiri --use-system-librariesand then run
- Start the jekyll server by running
bundle exec jekyll serve.
- You can then see the website at http://localhost:4000.
Forking for a New Conference
For a new conferences, you may either set up a repository from scratch by forking the original [Minimal Mistakes repository]((https://mmistakes.github.io/minimal-mistakes/) or you may fork this repository directly. The latter may be easiest since all of the changes that are required for more complex things like the web-based schedule to work are already there. However, the disadvantage of forking this repository is that the version of the Minimal Mistakes theme will be out of date and you might miss out on bugfixes and new features.
Note also that if you fork this repository, you will get all of the existing conference's pages and blog posts and schedule and other content. Therefore, it is up to you to modify/temporarily remove that content before you make your website public so that your new domain is not indexed by search engines with old content. It might be best to rename the
gh-pages branch so that the website for the new
conference does not get built with content from the old conference. You can rename the branch back to
gh-pages once you have made sufficient changes locally to remove/modify the old conference content.
If you fork this repository, the following files are the ones to pay attention to in order to create content for the website:
_pages/xxx.md: The markdown files contain the main contents of the different web pages of the website. Please note that once you fork, you would need to move the already existing .md files out into a different folder so that old pages do not get rendered into the new website.
downloads/: Contains files that can be downloaded from the website.
_sass/minimal-mistakes/*.scss: SASS files that control the look and the feel of the website. The file
_program.scssis not part of the them and controls the look and feel of the web schedule page.
_data/navigation.xml: YAML file that contains the links in the masthead at the top of the website and also links in the various sidebars.
_config.yml: YAML file that contains meta-information about the website that should be set properly for a new conference. Details are given in the comments in the file. You must edit this file properly before making the website public.
_posts/*.md: If you are going to have a blog, this where the blog posts live and are named
YYYY-MM-DD-title.md. Same as the files under
_pages, you should move out already existing files from this folder to prevent them from getting rendered.
CNAME: You should delete this file since this contains the old external domain from the older conference. This file will be automatically re-generated when you add the new external domain for the new conference. If you do not remove this file, you will get a page build warning from GitHub.
The following settings connect the the main domain booked for the conference (e.g.
naacl2019.org) with the underlying Github Pages build.
On the domain side, the following DNS settings need to be set up: all four IPs belong to Github, the last row connects the www subdomain to the main domain:
A @ 22.214.171.124 A @ 126.96.36.199 A @ 188.8.131.52 A @ 184.108.40.206 CNAME www naacl2019.org
In the settings for the repository on GitHub, the "custom domain" needs to be set to the main domain (
naacl2019.org). This will create a CNAME file in the top folder of the Github repository. Note that it may take a few minutes for the changes to become effective until they are propagated through the DNS servers.
The MIT License (MIT)
Copyright (c) 2018 Association for Computational Linguistics.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.