feat: include full content path in pub_dir arg

Give users full control over output path and allows outputting to language specific sub-folders.

Also remove --kind from Hugo new command based on Hugo 0.89 release notes.

Author: gcushen

README.md

@@ -24,7 +24,7 @@ To help us develop this Academic CLI tool and the associated Wowchemy software s
 
 Support development of the Academic CLI:
 
-  - ❤️ [Become a **backer** and **unlock rewards**](https://wowchemy.com/sponsor/)
+  - ❤️ [Become a **GitHub Sponsor** and **unlock perks**](https://github.com/sponsors/gcushen)
   - ☕️ [**Donate a coffee**](https://paypal.me/cushen)
   - 👩‍💻 [**Contribute**](#contribute)
 
@@ -65,16 +65,20 @@ Use the `cd` command to navigate to your website folder in the terminal:
 
     academic import --bibtex my_publications.bib
 
+**Import publications to a specific folder (e.g. `content/zh/publication`):**
+
+    academic import --bibtex my_publications.bib --publication-dir "content/zh/publication"
+
 Optional arguments:
 
-* `--help` Help
-* `--featured` Flag publications as *featured* (to appear in *Featured Publications* widget)
+* `--publication-dir PUBLICATION_DIR` Folder to import publications to (defaults to `content/publication`)
 * `--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
+* `--featured` Flag publications as *featured* (to appear in *Featured Publications* widget)
 * `--verbose` or `-v` Show verbose messages
+* `--help` Help
 
-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/content/publications/#command-line).
+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/content/publications/).
 
 **Run a Hugo command (pass-through):**
 
@@ -99,6 +103,4 @@ Preparing a contribution:
 
 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)
+Licensed under the [MIT License](https://github.com/wowchemy/hugo-academic-cli/blob/main/LICENSE.md).

academic/cli.py

@@ -42,11 +42,7 @@ def parse_args(args):
     )
     parser_a.add_argument("--bibtex", required=False, type=str, help="File path to your BibTeX file")
     parser_a.add_argument(
-        "--publication-dir",
-        required=False,
-        type=str,
-        default="publication",
-        help="Directory that your publications are stored in (default `publication`)",
+        "--publication-dir", required=False, type=str, default="publication", help="Path to import publications to (default `content/publication`)",
     )
     parser_a.add_argument("--featured", action="store_true", help="Flag publications as featured")
     parser_a.add_argument("--overwrite", action="store_true", help="Overwrite existing publications")

academic/import_bibtex.py

@@ -18,7 +18,7 @@
 
 
 def import_bibtex(
-    bibtex, pub_dir="publication", featured=False, overwrite=False, normalize=False, dry_run=False,
+    bibtex, pub_dir=os.path.join("content", "publication"), featured=False, overwrite=False, normalize=False, dry_run=False,
 ):
     """Import publications from BibTeX file"""
     from academic.cli import AcademicError, log
@@ -42,14 +42,14 @@ def import_bibtex(
 
 
 def parse_bibtex_entry(
-    entry, pub_dir="publication", featured=False, overwrite=False, normalize=False, dry_run=False,
+    entry, pub_dir=os.path.join("content", "publication"), featured=False, overwrite=False, normalize=False, dry_run=False,
 ):
     """Parse a bibtex entry and generate corresponding publication bundle"""
     from academic.cli import log
 
     log.info(f"Parsing entry {entry['ID']}")
 
-    bundle_path = f"content/{pub_dir}/{slugify(entry['ID'])}"
+    bundle_path = os.path.join(pub_dir, slugify(entry["ID"]))
     markdown_path = os.path.join(bundle_path, "index.md")
     cite_path = os.path.join(bundle_path, "cite.bib")
     date = datetime.utcnow()
@@ -77,7 +77,7 @@ def parse_bibtex_entry(
     # Prepare YAML front matter for Markdown file.
     hugo = utils.hugo_in_docker_or_local()
     if not dry_run:
-        subprocess.call(f"{hugo} new {markdown_path} --kind publication", shell=True)
+        subprocess.call(f"{hugo} new {markdown_path}", shell=True)
         if "docker-compose" in hugo:
             time.sleep(2)
 

academic/version.py

@@ -1 +1 @@
-version = "0.7.0"
+version = "0.8.0"