Problem beim Formatieren der HTML-Formatierung mit gitbook und split_by

Oct 10 2020

Ich erstelle einen Gitbook-Bericht mit Rstudio, dem Bookdown-Paket.

Es ist ziemlich einfach in Bezug auf den zugrunde liegenden R-Code, nur ein paar kürzliche Verbesserungen für:

  1. Reduzieren von Text auf 80% der Seitenbreite
  2. mit doppelten Spalten und
  3. Hinzufügen der Zeilennummer im angezeigten R-Code.

Alles funktioniert gut, außer wenn ich " split_by: rmd" in der _output.yml hinzugefügt habe. Dabei berücksichtigt die resultierende Ausgabe nicht mehr den Rand um den Text.

Ich weiß noch nicht viel über HTML, aber ein Blick auf den HTML-Inspektor ergab, dass sich die Abschnitte bei Verwendung von " split_by: rmd" außerhalb der Formatierung der Innenseite befinden.

Standard (kein split_by-Argument):

Mit split_by: rmd

Dies ist eine Aufnahme im Dunkeln, da ich den Code nicht freigeben kann und den Fehler mit dem minimalen Bookdown-Beispiel von Yihui nicht reproduzieren kann: https://github.com/rstudio/bookdown-demo.

Alle Hinweise, um die Ursache des Fehlers zu identifizieren oder noch besser eine Lösung vorzuschlagen, wären sehr willkommen!

Erstellen des Buches aus einem R-Skript:

bookdown::render_book(
  input = "index.Rmd",
  output_format = "bookdown::gitbook",
  output_dir = paste0("gitbook-", format(Sys.time(), format = "%Y-%m-%d-%H%M%S"))
)

index.rmd YAML-Header:

---
title: "blahblah"
subtitle: "blahblahblah"
author: "DRAFT"
date: "August 2020"
documentclass: article
fontsize: 12pt
geometry: margin=2cm
link-citations: yes
#mainfont: Arial
bibliography: packages.bib
site: bookdown::bookdown_site
biblio-style: apalike
urlcolor: blue
---

```{r setup, include=FALSE}

knitr::opts_chunk$set(echo = TRUE, eval = FALSE, attr.source='.numberLines') table_format <- knitr::opts_knit$get('rmarkdown.pandoc.to')

if (table_format %in% c("html", "latex")) {
  library(kableExtra)
  knitr::opts_chunk$set(fig.pos='H', fig.align='center', out.width='80%')
}

## Automatically create a bib database for R packages
knitr::write_bib(c(.packages(), 'bookdown', 'knitr', 'rmarkdown', 'Hmisc'), 'packages.bib')
```

_output.yml:

bookdown::gitbook:
      css: style.css
      config:
        toc:
          before: |
            <li><a href="./">My book title</a></li>
          #after: |
          #  <li><a href="https://github.com/rstudio/bookdown" target="blank">Published with bookdown</a></li>
        edit: null
        download: null
        sharing: null
        info: null
      split_bib: FALSE
      split_by: rmd

style.css:

p.caption {
  color: #777;
  margin-top: 10px;
}
p code {
  white-space: inherit;
}
pre {
  word-break: normal;
  word-wrap: normal;
}
pre code {
  white-space: inherit;
}

/* watermark for draft report
.watermark {
  opacity: 0.2;
  position: fixed;
  top: 45%;
  left: 45%;
  font-size: 500%;
  color: #606099;
  z-index: 1000000;
}
*/

.book .book-body .page-wrapper .page-inner {
  max-width: 80% !important;
}

/* Increase space to display line number in R chunks correctly */
pre.numberSource code > span > a:first-child::before {
  left: -0.3em;
}

/* for multi cols */
/*.cols {display: flex; } /* uncomment for flex column size */
.cols {display: grid; grid-template-columns: 30% 50% 20%;} /* for fixed column size */

Antworten

1 GaelS Oct 12 2020 at 22:23

Ich stellte fest, dass der Ursprung des Problems der war, den \newpageich am Anfang jeder rmd-Datei zum Erstellen des Berichts im PDF-Format hinzugefügt habe.

Lösung 1: war zu ändern split_by: rmd, split_by: sectionda meine rmd-Dateien hauptsächlich Abschnitten der Ebene 2 entsprechen.

Lösung 2: Es sollte ein Wrapper herumgelegt \newpagewerden, damit sie nicht ausgewertet werden, wenn die Ausgabe HTML ist:

`r if (knitr::opts_knit$get('rmarkdown.pandoc.to') != "html") '
\\newpage
'`

Andere Ansätze für Lösung 2 wurden hier beschrieben: Wie kann man \ newpage in Rmarkdown auf intelligente Weise hinzufügen?