Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Updates for new Roxygen and Gitbook.
- Loading branch information
Showing
14 changed files
with
65 additions
and
71 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -18,3 +18,4 @@ Imports: | |
utils,knitr,knitcitations | ||
Suggests: | ||
devtools | ||
Roxygen: list(wrap=FALSE) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,32 +1,28 @@ | ||
% Generated by roxygen2 (4.0.0): do not edit by hand | ||
\name{buildRmd} | ||
\alias{buildRmd} | ||
\title{Builds markdown files from all Rmarkdown files in the given directories.} | ||
\usage{ | ||
buildRmd(dir = getwd(), clean = FALSE, log.dir, log.ext = ".txt", ...) | ||
} | ||
\arguments{ | ||
\item{dir}{root directory of the gitbook project.} | ||
\item{dir}{root directory of the gitbook project.} | ||
|
||
\item{clean}{if TRUE, all Rmd files will be built | ||
regardless of their modification date.} | ||
\item{clean}{if TRUE, all Rmd files will be built regardless of their | ||
modification date.} | ||
|
||
\item{log.dir}{if specified, the output from | ||
\code{\link{knitr}} will be saved to a log file in the | ||
given directory.} | ||
\item{log.dir}{if specified, the output from \code{\link{knitr}} will be saved | ||
to a log file in the given directory.} | ||
|
||
\item{log.ext}{if log files are saved, the file extension | ||
to use.} | ||
\item{log.ext}{if log files are saved, the file extension to use.} | ||
|
||
\item{...}{other parameters passed to | ||
\code{\link{knit}}.} | ||
\item{...}{other parameters passed to \code{\link{knit}}.} | ||
} | ||
\description{ | ||
This function will build Rmarkdown files in the given | ||
directory to markdown. The default is to traverse all | ||
subdirectories of the working directory looking for .Rmd | ||
files to process. This function will save a file in the | ||
working directory called \code{.rmdbuild} that contain the | ||
status of the last successful build. This allows the | ||
function to only process changed files. | ||
This function will build Rmarkdown files in the given directory to markdown. | ||
The default is to traverse all subdirectories of the working directory | ||
looking for .Rmd files to process. This function will save a file in the | ||
working directory called \code{.rmdbuild} that contain the status of the | ||
last successful build. This allows the function to only process changed files. | ||
} | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,16 +1,15 @@ | ||
% Generated by roxygen2 (4.0.0): do not edit by hand | ||
\name{checkForGitbook} | ||
\alias{checkForGitbook} | ||
\title{Check if Gitbook is installed.} | ||
\usage{ | ||
checkForGitbook(quiet = FALSE) | ||
} | ||
\arguments{ | ||
\item{quiet}{logical indicating whether messages should | ||
be printed.} | ||
\item{quiet}{logical indicating whether messages should be printed.} | ||
} | ||
\description{ | ||
If Gitbook is not installed it will try to do so. If the | ||
installion fails or Node.js is not installed, an error will | ||
be thrown. | ||
If Gitbook is not installed it will try to do so. If the installion fails or | ||
Node.js is not installed, an error will be thrown. | ||
} | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,16 +1,16 @@ | ||
% Generated by roxygen2 (4.0.0): do not edit by hand | ||
\name{initGitbook} | ||
\alias{initGitbook} | ||
\title{Create files and folders based on contents of SUMMARY.md.} | ||
\usage{ | ||
initGitbook(dir = getwd()) | ||
} | ||
\arguments{ | ||
\item{dir}{source directory for the Gitbook.} | ||
\item{dir}{source directory for the Gitbook.} | ||
} | ||
\description{ | ||
This first calls system command \code{gitbook init} but | ||
then will change the all the file extensions from | ||
\code{.md} to \code{.Rmd} excluding \code{SUMMARY.md} and | ||
\code{README.md}. | ||
This first calls system command \code{gitbook init} but then will change | ||
the all the file extensions from \code{.md} to \code{.Rmd} excluding | ||
\code{SUMMARY.md} and \code{README.md}. | ||
} | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,18 +1,18 @@ | ||
% Generated by roxygen2 (4.0.0): do not edit by hand | ||
\name{installGitbook} | ||
\alias{installGitbook} | ||
\title{This will install Gitbook.io.} | ||
\usage{ | ||
installGitbook() | ||
} | ||
\description{ | ||
This function will install Gitbook from | ||
\url{http://nodejs.org/download/} regardless if the current | ||
version. That is, this function will either update or | ||
install a new version of Gitbook.io. | ||
This function will install Gitbook from \url{http://nodejs.org/download/} | ||
regardless if the current version. That is, this function will either update | ||
or install a new version of Gitbook.io. | ||
} | ||
\details{ | ||
On many systems this function will not work as installing | ||
requires root access. The function will print the required | ||
commands for you to copy-and-paste to the terminal. | ||
On many systems this function will not work as installing requires root | ||
access. The function will print the required commands for you to copy-and-paste | ||
to the terminal. | ||
} | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,14 +1,15 @@ | ||
% Generated by roxygen2 (4.0.0): do not edit by hand | ||
\name{newGitbook} | ||
\alias{newGitbook} | ||
\title{Initializes a new Gitbook.} | ||
\usage{ | ||
newGitbook(dir) | ||
} | ||
\arguments{ | ||
\item{dir}{location of the built gitbook.} | ||
\item{dir}{location of the built gitbook.} | ||
} | ||
\description{ | ||
This will initalize a new Gitbook in the given directory. | ||
When done, it will also change the working directory. | ||
This will initalize a new Gitbook in the given directory. When done, it will | ||
also change the working directory. | ||
} | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,15 +1,15 @@ | ||
% Generated by roxygen2 (4.0.0): do not edit by hand | ||
\name{openGitbook} | ||
\alias{openGitbook} | ||
\title{Open a built gitbook.} | ||
\usage{ | ||
openGitbook(out.dir = paste0(getwd(), "/_book")) | ||
} | ||
\arguments{ | ||
\item{out.dir}{location of the built gitbook.} | ||
\item{out.dir}{location of the built gitbook.} | ||
} | ||
\description{ | ||
This function is a wrapper to the system call of | ||
\code{open} which should open the book in the system's | ||
default web browser. | ||
This function is a wrapper to the system call of \code{open} which should | ||
open the book in the system's default web browser. | ||
} | ||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters