doc: added a note to the bookdown example and to the Word template skeleton

Author: davidgohel

inst/examples/bookdown/02-toc.Rmd

@@ -1,5 +1,12 @@
 # Tables of content {#toc}
 
+> Note: tables of content, figures and tables are Word *fields*. They are
+> **computed by Word, not by officedown**. When you first open the generated
+> document, Word shows the placeholder "No table of contents entries found"
+> until the fields are updated: select all (`Ctrl+A`) then press `F9`, or
+> right-click a table and choose "Update Field" (fields are also refreshed when
+> printing). LibreOffice does not update these fields.
+
 ## Table of figures
 
 <!---BLOCK_TOC{style: 'Image Caption'}--->

inst/examples/bookdown/03-tables.Rmd

@@ -29,7 +29,7 @@ if(require("flextable")){
   ft <- fontsize(ft, size = 9, part = "all")
   ft <- compose(x = ft, j = "mpg",
     value = as_paragraph(
-      value = lollipop(value = mpg, min = 0, max = 30, positivecol = "#DD2233", rangecol = "#DD2233")
+      value = minibar(value = mpg, min = 0, max = 30, barcol = "#DD2233")
       ))
   ft <- compose(x = ft, j = "drat",
     value = as_paragraph(

inst/rmarkdown/templates/word/skeleton/skeleton.Rmd

@@ -29,6 +29,10 @@ This document presents most of the features of the package `r ftext("officedown"
 
 ## Table of content
 
+> These tables are Word fields, computed by Word and not by officedown. When the
+> document opens, update the fields to populate them (`Ctrl+A` then `F9`, or
+> right-click > "Update Field"); LibreOffice does not update them.
+
 <!---BLOCK_TOC--->
 
 ## List of figures