Data and software for building the ACL Anthology.
To build the Anthology website, you will need:
bin/requirements.txt; to install, run
pip -r bin/requirements.txt
makethe first time, the libyaml C library will be used instead of a python implementation, speeding up the build.
There is a GitHub actions action performing deployment directly from GitHub. To use this, you need to define these variables in your repository settings (web interface: settings -> secrets):
PUBLISH_TARGET: rsync will push the anthology to this target (e.g.
PUBLISH_SSH_KEY: the secret key in standard pem format for authentication (without a passphrase)
PUBLISH_ANTHOLOGYHOST: The host which will serve the anthology later on (e.g.
GitHub will then automatically build and deploy the current master whenever the master branch changes.
Clone the Anthology repo to your local machine:
$ git clone https://github.com/acl-org/acl-anthology
Provided you have correctly installed all requirements, building the website should be as simple running
makefrom the directory to which you cloned the repo.
The fully generated website will be in
build/anthologyafterwards. If any errors occur during this step, you can consult the detailed README for more information on the individual steps performed to build the site. You can see the resulting website by launching a local webserver with
make serve, which will serve it at http://localhost:8000.
Note that building the website is quite a resource-intensive process; particularly the last step, invoking Hugo, uses about 18~GB of system memory. Building the anthology takes about 10 minutes on a laptop with an SSD.
(Note: This does not mean you need this amount of RAM in your system; in fact, the website builds fine on a laptop with 8 GB of RAM. The system might temporarily slow down due to swapping, however. The figure of approx. 18 GB is the maximum RAM usage reported when running
hugo --minify --stepAnalysis.)
The anthology can be viewed locally by running
hugo serverin the
hugo/directory. Note that it rebuilds the site and therefore takes about a minute to start.
If you'd like to contribute to the ACL Anthology, please take a look at:
This repo was originally wing-nus/acl and has been transferred over to acl-org as of 5 June 2017.
The code for building the ACL Anthology is distributed under the Apache License, v2.0.