Skip to main content

The website designer for Hugo

Project description

Admin Tool for Academic

Download from PyPI Download from Anaconda License

An admin tool for Academic.


  • Import publications from BibTeX
  • Import third-party assets to generate an entirely offline site


  1. Install the Academic website framework
  2. Install Python 3.6+ if it’s not already installed
  3. Version control your website with Git so that you can review the proposed changes and accept or reject them without risking breaking your site. Otherwise, if not using Git, backup your site prior to running this tool.


Open your Terminal or Command Prompt app and install Academic’s admin tool:

pip3 install -U academic


Use the cd command to navigate to your website folder in the terminal:




Import publications:

academic import --bibtex my_publications.bib

Optional arguments:

  • --help Help
  • --featured Flag publications as featured (to appear in Featured Publications widget)
  • --overwrite Overwrite existing publications
  • --publication-dir PUBLICATION_DIR Path to your publications directory (defaults to publication)
  • --normalize Normalize tags by converting them to lowercase and capitalizing the first letter
  • --verbose or -v Show verbose messages

After importing publications, a full text PDF and image can be associated with each item and further details added via extra parameters.

Import third-party JS and CSS assets for building an offline website:

academic import --assets

Importing assets requires Academic v3+.

Run a Hugo command (pass-through):

academic server


For local development, clone this repository and install the tool using the following command:

pip3 install -e .


Support development of Academic:


Copyright 2018-present George Cushen.

Licensed under the MIT License.


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for academic, version 0.5.1
Filename, size File type Python version Upload date Hashes
Filename, size academic-0.5.1-py3-none-any.whl (9.6 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size academic-0.5.1.tar.gz (9.0 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page