High-Performance Open-Source Archive
NOTE (#359).In 0.5.0, we announced that README.qmd wouldn’t be
automatically rendered, but this still happened when
output = "quarto_website". This is now fixed, meaning that
altdoc uses README.md over
README.qmd (#354).
Figures stored in man/figures and used in the README
are now properly displayed (#354).
Fix for change of default value of
getOption("help.htmltoc") in R-devel 4.6.0 (#356).
When using mkdocs as documentation generator, the
Python virtual environment to be used can now be set with the
environment variable ALTDOC_VENV. It doesn’t have to be
.venv_altdoc located at the project root anymore
(#339).
render_docs() now updates the file
altdoc/pkgdown.yml. This file was also adapted so that it
can be used by R-universe to display a link to the package website
(#344).
mkdocs as documentation generator, changes
in settings such as overrides templates or CSS files are now correctly
applied to docs/index.html. Previously, it was required to
manually delete the file and run render_docs() again
(#337).The CSS for arguments table in “Reference” page has changed a bit. Argument names are now wrapped so that they have limited width, improving the readability in case of multiple arguments on the same line (#308).
Files stored in man/figures (such as
lifecycle badges) are now properly included by
render_docs() (#321).
Fix a quarto_website rendering failure when the
package being rendered has its URL or BugReports set to a site other
than GitHub (#319, @gardiners).
Fix footer in docsify when a package doesn’t have a
website or GitHub URL (#324).
render_docs() now shows an explicit error message if
Quarto is not installed on the system (#329).
Fix an error in render_docs() when the title in the
Rd file is split across several lines (#333).
README.qmd is no longer required to create a
quarto_website, only README.md (#295).Simplified rendering for Quarto websites. Previously, the website
was rendered into _quarto/_site and manually copied over to
docs/. The new version removes this logic and instead uses
the output-dir project option. To transition, change
quarto_website.yml to:
project:
output-dir: ../docs/render_docs(freeze = TRUE) now works correctly when
output is "quarto_website". Freezing a document needs to be
set either at a project or per-file level. To do so, add to either
quarto_website.yml or the frontmatter of a file:
execute:
freeze: autoFor Quarto websites, render_docs() can use the
downlit package to automatically link function calls to
their documentation on the web. Turn off by modifying the
code-link line in
altdoc/quarto_website.yml
Citation is now formatted with HTML instead of verbatim (#282, Achim Zeileis).
The \doi{} tags in Rd files are now linked once
rendered (#282, Achim Zeileis).
Warn if README.qmd does not exist when calling
setup_docs("quarto_website"). Issue #280.
github-pages-deploy-action to v4@examplesIf tag in roxygen2All functions have changed so any change listed below technically is a breaking change.
use_docute(), use_docsify() and
use_mkdocs() are combined into
setup_docs()update_docs() -> render_docs()preview() -> preview_docs()setup_docs() (previously use_*()) no
longer updates and previews the website by default.custom_reference argument is removed. See the
Post-processing vignette for a description of the new
proposed workflow.theme argument is removed. Users can change themes by
editing settings files in altdoc/mkdocs documentation is no longer stored in
docs/docs/Support Quarto websites as a documentation format.
Support Quarto vignettes (.qmd) in the vignettes/
folder.
render_docs(parallel = TRUE) uses
future to parallelize the rendering of vignettes and man
pages.
render_docs(freeze = TRUE) no longer renders
vignettes or man pages when they have not changed and are already stored
in docs/.
Link to source code at the top of function reference.
Settings files are now permanently stored in the
altdoc/ directory. These files can be edited manually to
customize the website.
Major internal changes to the .Rd -> .md conversion system. We now use Quarto to convert man pages and execute examples, and the man pages are stored in separate markdown files instead of combined in a single large file.
mkdocs now behaves like the other documentation
generators and stores its files in docs/. This means that
mkdocs websites can be deployed to Github Pages.
Improved vignettes
Do not reformat markdown header levels automatically, but raise a warning when there is more than one level 1 header.
Fewer dependencies.
Fix parsing for issue/PR references like [org/repo#111].
Changelog and News sections can be present simultaneously.
Support for NEWS.Rd, either in the root folder or in
inst/
Automatically create a Github Actions workflow with
setup_github_actions().
Skip .Rd files when they document internal functions.
If necessary, two spaces are automatically added in nested lists
in the NEWS (or Changelog) file.
This is the last release before a large rework of this package.
usethis (see
https://github.com/cynkra/fledge/issues/683)./docs
(use_docsify() = _sidebar.md;
use_docute() = index.html;
use_mkdocs() = mkdocs.yml).update_docs() now updates the package version as
well as altdoc version in the footer.
The NEWS or Changelog file included in the docs now automatically links issues, pull requests and users (only works for projects on Github).
Vignettes are now always rendered by use_*() or
update_docs(). Therefore, the argument
convert_vignettes is removed. Previously, they were only
rendered if their content changed. This was problematic because the code
in a vignette can have different output while the vignette in itself
doesn’t change (#37, #38).
New argument custom_reference in
use_*() and update_docs(). If it is a path to
a custom R file then it uses this file to build the “Reference” section
in the docs (#35).
Need mirroring services?
Contact our team at info@vpspulse.com.
Mirror powered by VPSpulse
Infrastructure sponsored by VPSPulse & Secure Payments by ArionPay.