Skip to content
NAACL-HLT 2019 Website
Branch: gh-pages
Clone or download
Latest commit 400a99b Jun 23, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Add CODEOWNERS file. May 21, 2019
_data Fix github link Jun 23, 2019
_includes
_layouts Update minimal-mistakes to latest release Jun 18, 2019
_pages Add blog post about conference materials. Jun 20, 2019
_posts Add blog post about conference materials. Jun 20, 2019
_sass Update minimal-mistakes to latest release Jun 18, 2019
agenda @ f475aab Add intro slides Jun 10, 2019
assets Add more comments to javascript code. Jun 20, 2019
downloads Add blog post about conference materials. Jun 20, 2019
webagenda Merge pull request #34 from naacl-org/update-jspdf-and-autotable Jun 20, 2019
.gitignore Add gitignore file. Jul 2, 2018
.gitmodules Add naacl-schedule-2019 repo as agenda submodule. May 14, 2019
CNAME Create CNAME Jun 7, 2018
Gemfile Update minimal-mistakes to latest release Jun 18, 2019
Gemfile.lock Update minimal-mistakes to latest release Jun 18, 2019
LICENSE.txt Very basic website. Jul 2, 2018
README.md Another bug in README. May 23, 2019
Rakefile Very basic website. Jul 2, 2018
_config.yml Update minimal-mistakes to latest release Jun 18, 2019
banner.js Very basic website. Jul 2, 2018
minimal-mistakes-jekyll.gemspec Update minimal-mistakes to latest release Jun 18, 2019
package.json Update minimal-mistakes to latest release Jun 18, 2019
staticman.yml Update minimal-mistakes to latest release Jun 18, 2019

README.md

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:

  1. Install bundler: sudo gem install bundler. Make sure you have Ruby and Bundler versions > 2.4.
  2. Clone this repository. Note that this repository uses submodules so to properly check out the submodule code, run git submodule init and git submodule update after you clone the repository. You will need the submodule to generate the schedule for the website.
  3. Run the gems needed by this repository: sudo bundle install. Note: This step might fail when installing the nokogiri gem. If this happens, run bundle config build.nokogiri --use-system-libraries and then run bundle install again.
  4. Start the jekyll server by running bundle exec jekyll serve.
  5. 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.

Important Files

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.scss is 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.

Domain Setup

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   @   185.199.108.153 
A   @   185.199.109.153 
A   @   185.199.110.153 
A   @   185.199.111.153 
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.

License

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.

You can’t perform that action at this time.