9月 242018
 

The Story

Many years ago, I collected some LaTeX templates when learning LaTeX. However, my interest in LaTeX was gone after submitting my PhD dissertation. I should have deleted these templates if they had not been so small. They would never be useful in the future, I thought.

In 2017, I started writing the book Learning R: R for Rookies . Unexpectedly, MS Word could not satisfy me with the typesetting. You know what I mean if you have experience (and pain) in writing a long book or dissertation with Word. Actually I suffered more, but I do not want to talk about it. I was sure that LaTeX could, but I would rather not use it.

Like a bolt out of the blue, I found bookdown.

From then on, I could not help spending time on this amazing tool. My book was completed with bookdown. My manuscripts, produced by bookdown, were submitted to academic journals and accepted. I wrote my papa-and-son diaries on bookdown.org. All the LaTeX templates were brought back to life: I packed them in an R package: bookdownplus.

Bookdownplus was supppsed to be a shortcut to bookdown. In the recently year, I have been doing my best to provide the beginners (and me) a friendly way to using bookdown. However, I struggled with two annoying problems. The first one is how the users (including me) can easily choose the right template. The second one is how the users (including me) can easily contribute their own templates to bookdownplus.

The web app for bookdownplus is intended to solve these problems. Users can search for elegant bookdown templates of interest, download the template package, and leave their comments. Furthermore, contributors’ templates, if submitted to the bookdownplus repository, can view their templates on this website as soon as possible.

In another word, this web app is a showcase of the R bookdownplus package, or a window of bookdown templates.

What is bookdownplus?

bookdownplus is an open-source software package that helps users write many kinds of books and articles, including academic journal articles, theses and dissertations, programming books (especially in R language), even guitar books, chemical equations, mails, calendars, and diaries. bookdownplus works on the basis of bookdown.

You don’t know which template to choose? The web app for bookdownplus is a gallery of them, each with a title of the template name.

Share your own templates

If you are willing to share your bookdown templates, just upload them to the bookdownplus repo. They will be displayed in the gallery automatically once accepted.

From the version 1.5, bookdownplus opens a widest-ever door to contributors. Here is how:

  1. Make sure that your template works successfully with bookdown.
  2. Prepare a folder in your working directory by running bookdownplus::share('your_template_name') . Follow the instructions in each subfolder and create the required files.
    • (Mandatory) ‘your_template_name/demo.zip’ is the compressed file from your bookdown project folder.
    • (Optional) ‘your_template_name/showcase/’ contains the sample files (e.g. pdf, image files). An image file ‘cover.png’ is recommended, which will be used as the cover image in the gallery.
    • (Optional) You could write a ‘your_template/readme.txt’ (in markdown syntax), which will be displayed as the text in the gallery.
  3. Upload your template folder ‘your_template_name/’ in to ‘upload/‘ of the bookdownplus repo.
  4. Add the template information, including the template name, the contributor’s name, and a brief introduction, into ‘upload/-list.csv’.
  5. Create a Pull Request to bookdownplus.

Wait for the response, and your template will be available in the gallery.

Any suggestions? Please contact me!

 填写评论

To create code blocks or other preformatted text, indent by four spaces:

    This will be displayed in a monospaced font. The first four 
    spaces will be stripped off, but all other whitespace
    will be preserved.
    
    Markdown is turned off in code blocks:
     [This is not a link](http://example.com)

To create not a block, but an inline code span, use backticks:

Here is some inline `code`.

For more help see http://daringfireball.net/projects/markdown/syntax

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>

(必填)

(必填)

This site uses Akismet to reduce spam. Learn how your comment data is processed.