These are basic instructions on generating the ACL Anthology website as seen on https://aclweb.org/anthology/. The offical home of this repository is https://github.com/acl-org/acl-anthology.
To build the Anthology website, you will need:
- Python 3.7 or higher, along with the packages listed in
bin/requirements.txt
- Note: You can install all needed dependencies using the command
pip install -r bin/requirements.txt - Note: Installing the PyYAML package with C bindings will speed up the generation process.
- Note: You can install all needed dependencies using the command
- Hugo 0.54 or higher (can be downloaded directly from their repo; the extended version is required!)
- bibutils for creating non-BibTeX citation formats (not strictly required to build the website, but without them you need to invoke the build steps manually as laid out in the detailed README)
Clone the Anthology repo to your local machine:
$ git clone https://github.com/acl-org/acl-anthologyProvided you have correctly installed all requirements, building the website
should be as simple running make from the directory to which
you cloned the repo.
The fully generated website will be in build/anthology afterwards. 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 server in 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:
- our Github issues page
- our call for volunteers
- the detailed README which contains more in-depth information about generating and modifying the website.
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.