Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

openbases/openbases-pdf

Open more actions menu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

47 Commits
47 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Open Bases Paper Base

docs/img/logo-small.png

Hi friend! 👋

This is an automated build for a Docker container to build you a paper! If you want to use the builder for your repository, you can read full instructions at openbases/builder-pdf.

Usage

You can build your pdf locally! Here is how to look at usage:

$ docker run openbases/openbases-pdf

Usage:

         docker run <options> <container> <action> [options] ...
         docker run -v /data:/data <container> pdf

         **All input files should be mounted as volume at /data in container
         
         Action [pdf] Options:

         pdf:

             --md: pdf input markdown file (default paper.md)
             --bib: custom bib file (default paper.bib)
             --minimal: create a minimal pdf (no template, etc.)
             --logo: add a 'logo.png' to the same directory as your paper
             --name: customize the name of the resulting pdf (default paper.pdf)
             --template: use a custom template (put in mounted /data)

         pub:

             --issue: Github issue of associated review
             --year: year for publication
             --volume: volume for publication

         Examples:

              docker run -v /data:/data <container> pdf --minimal

Now since we want to generate a PDF, we would specify "pdf" as the first argument to the entrypoint. If we don't bind any folders, we can specify a demo provided in the container.

$ docker run openbases/openbases-pdf pdf 

If you want to bind the output folder to your computer to see what is generated, you can do that!

mkdir -p output
docker run -v $PWD/output:/data openbases/openbases-pdf pdf
vanessa@vanessa-ThinkPad-T460s:~/Documents/Dropbox/Code/openbases/openbases-pdf$ tree output/
output/
├── paper.bib
├── paper.md
└── paper.pdf

But likely you want to specify your own input files! Let's do that. In the folder paper in the present working directory we have a paper.md and paper.bib. Let's see if this still generates the proper output.

rm output/*
docker run -v $PWD/paper:/data openbases/openbases-pdf pdf
$ tree output/
output/
├── paper.bib
├── paper.md
└── paper.pdf

And remember that you can customize all of these variables - the default simply intends (or tries) to make this easiest for you!

  --md: pdf input markdown file (default paper.md)
  --bib: custom bib file (default paper.bib)
  --minimal: create a minimal pdf (no template, etc.)
  --logo: add a 'logo.png' to the same directory as your paper
  --name: customize the name of the resulting pdf (default paper.pdf)
  --template: use a custom template (put in mounted /data)

Development

Build the container locally. See openbases/builder-pdf for usage.

docker build -t openbases/openbases-pdf .

Have a question or need help? Please open an issue

Morty Proxy This is a proxified and sanitized view of the page, visit original site.