Reglas por las cuales Rstudio establece encabezados

Question

RStudio reconoce automáticamente los encabezados en un script R que se establece a través de comentarios:

Me gustaría explotar esa característica, pero no entiendo cuáles son las reglas para que Rstudio las reconozca como encabezados. ¿Alguien puede explicar?

Answer 1

Verificar Código de plegado y secciones:

Las secciones de código le permiten dividir un archivo fuente más grande en un conjunto de regiones discretas para una fácil navegación entre ellos. Las secciones de código son automáticamente plegables; por ejemplo, el siguiente archivo de origen tiene tres secciones (una expandida y las otras dos plegadas):

Para insertar una nueva sección de código, puede usar el código -> Insertar el comando de sección. Alternativamente, cualquier línea de comentarios que incluya al menos cuatro guiones de final (-), signos iguales (=) o letreros de libra (#) crea automáticamente una sección de código. Por ejemplo, todas las siguientes líneas crean secciones de código:

# Seccion uno ---------------------------------
# Sección dos ===================================
### Sección tres ###########################

Tenga en cuenta que, como se ilustra arriba, la línea puede comenzar con cualquier número de letreros de libra (#) siempre que termina con cuatro o más -, = o # caracteres.

(Lo más destacado por mí mismo)

Answer 2

Rstudio parece reconocer los subtítulos cuando se encuentran dentro de las funciones. Por ejemplo:

# SECTION ONE -----------------------------------------------------------------

testfunc <- function(input1,input2,input3){

# SUBSECTION ONE --------------------------------------------------------------
# SUBSECTION TWO --------------------------------------------------------------
  ss2func <- function(x1,x2,x3){

  }
}

# SECTION TWO -----------------------------------------------------------------

Answer 3

Es un poco feo, pero si desea que una subsección se pliegue dentro de la sección pero también sea plegable por sí solo, puede usar aparatos ortopédicos rizados en cada extremo de la subsección.

# SECTION ONE --------------------------------------------------------------
y <- 11:20

{# SUBSECTION ONE ----------------------------------------------------------
x <- 1:10
}   

# SECTION TWO --------------------------------------------------------------

De esta manera, puede tener la subsección una doblada mientras aún ve el código en la sección uno. Pero si dobla la Sección Uno, una subsección también estará cerrada.