Metadata-Version: 2.1
Name: academic
Version: 0.7.0
Summary: Import publications from your reference manager to Hugo
Home-page: https://wowchemy.com
Author: George Cushen
Author-email: hugo-discuss@googlegroups.com
License: MIT
Description: # Hugo Academic CLI
        
        [![Download from PyPI](https://img.shields.io/pypi/v/academic.svg)](https://pypi.python.org/pypi/academic)
        [![Download from Anaconda](https://anaconda.org/conda-forge/academic/badges/version.svg)](https://anaconda.org/conda-forge/academic)
        [![License](https://img.shields.io/pypi/l/academic.svg)](https://pypi.python.org/pypi/academic)
        
        ### 📚 Import publications from your reference manager to [Hugo](https://gohugo.io/)
        
        **Features**
        
        * Import publications, including **books, conference proceedings and journals**, from your reference manager to your static site generator
          * Simply export a BibTeX file from your reference manager, such as [Zotero](https://www.zotero.org), and provide this as the input
        * Hugo command pass-through
        
        **Community**
        
        - 📚 [View the **documentation**](https://wowchemy.com/docs/managing-content/#create-a-publication) and usage guide below
        - 💬 [Chat with the **Wowchemy community**](https://discord.gg/z8wNYzb) or [**Hugo community**](https://discourse.gohugo.io)
        - 🐦 Twitter: [@wowchemy](https://twitter.com/wowchemy) [@GeorgeCushen](https://twitter.com/GeorgeCushen) [#MadeWithAcademic](https://twitter.com/search?q=(%23MadeWithWowchemy%20OR%20%23MadeWithAcademic)&src=typed_query)
        
        **❤️ Support this open-source software**
        
        To help us develop this Academic CLI tool and the associated Wowchemy software sustainably under the MIT license, we ask all individuals and businesses that use it to help support its ongoing maintenance and development via sponsorship and contributing.
        
        Support development of the Academic CLI:
        
          - ❤️ [Become a **backer** and **unlock rewards**](https://wowchemy.com/plans/)
          - ☕️ [**Donate a coffee**](https://paypal.me/cushen)
          - 👩‍💻 [**Contribute**](#contribute)
        
        ## Prerequisites
        
        1. Create a [Hugo](https://gohugo.io) website such as by using the [Hugo Academic Starter](https://github.com/wowchemy/starter-academic) template for the [Wowchemy](https://wowchemy.com) website builder
        1. [Download your site from GitHub, installing Hugo and its dependencies](https://wowchemy.com/docs/install-locally/)
        1. Install [Python 3.6+](https://realpython.com/installing-python/) if it’s not already installed
        1. [Version control](https://guides.github.com/introduction/git-handbook/#version-control) your website
           - Ideally, version control your site with [Git](http://rogerdudler.github.io/git-guide/) 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 folder** prior to running this tool
        
        ## Installation
        
        Open your Terminal or Command Prompt app and install the Academic CLI tool:
        
            pip3 install -U academic
        
        ## Usage
        
        Use the `cd` command to navigate to your website folder in the terminal:
        
            cd <MY_WEBSITE_FOLDER>
        
        **Help:**
        
            academic
        
        **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](https://wowchemy.com/docs/managing-content/#manually).
        
        **Run a Hugo command (pass-through):**
        
            academic server
        
        ## Contribute
        
        For local development, clone this repository and use Pipenv to install the tool using the following commands:
        
            git clone https://github.com/wowchemy/hugo-academic-cli.git
            cd hugo-academic-cli
            pip3 install pipenv
            pipenv install -e .
        
        Preparing a contribution:
        
        - Lint: `make lint`
        - Format: `make format`
        - Test: `make test`
        
        ## License
        
        Copyright 2018-present [George Cushen](https://georgecushen.com).
        
        Licensed under the [MIT License](https://github.com/wowchemy/hugo-academic-cli/blob/master/LICENSE.md).
        
        [![Analytics](https://ga-beacon.appspot.com/UA-78646709-2/hugo-academic-cli/readme?pixel)](https://github.com/igrigorik/ga-beacon)
        
Keywords: hugo academic cli wowchemy bibtex markdown latex tex theme static-site-generator cmsblog-engine github-pages netlify hugo-theme documentation-generator
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.6
Description-Content-Type: text/markdown
