sandpaper/_pkgdown.yml at ac · AuthorCarpentry/sandpaper · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
url: 'https://carpentries.github.io/sandpaper/'

home:
  title: The Carpentries Lesson Infrastructure Engine
  description: Create, Preview, and Maintain Carpentries-Style Lessons

template:
  bootstrap: 5
  opengraph:
    twitter:
      creator: "@zkamvar"
      site: "@thecarpentries"
      card: summary

code:
  width: 72

reference:
 - title: "Lesson Creation"
   desc: >
     Provision new lessons and/or episodes. These functions will likely only
     be used once.
 - contents:
   - create_lesson
   - create_episode
 - title: "Working With Lessons"
   desc: >
     Functions to work build, audit, and preview lesson content. These will be
     used with regularity in your work.
 - contents:
   - serve
   - build_lesson
   - sandpaper_site
   - validate_lesson
   - get_drafts
   - get_config
   - set_config
   - set_dropdown
   - get_episodes
   - set_episodes
   - get_syllabus
   - reset_episodes
   - reset_site
 - title: "The Pacakge Cache"
   desc: >
     Lessons with generated content (R Markdown lessons) have an extra file
     called `renv/profiles/lesson-requirments/renv.lock` that records the
     package versions used to build the lesson. These functions provide ways for
     you to manage these packages and turn it on or off while previewing the
     lesson.
 - contents:
   - use_package_cache
   - manage_deps
 - title: "Updating Lesson Tools"
   desc: >
     Lesson updates will happen automatically on a regular schedule on GitHub.
     If you want to expediate those updates or update the components on your own
     computer, these functions will help you with that.
 - contents:
   - update_varnish
   - update_cache
   - update_github_workflows
 - title: "[Internal] Continous Integration Functions"
   desc: >
     Internal functions for deploying on continuous integration. Users are not
     intended to work with these.
 - contents:
   - ci_deploy
   - ci_build_markdown
   - ci_build_site
   - ci_session_info
   - git_worktree_setup
 - title: "[Internal] Build Components"
   desc: >
     Individual components to provision files and build a lesson locally
 - contents:
   - this_lesson
   - build_handout
   - build_markdown
   - build_site
   - build_episode_md
   - build_episode_html
   - render_html
   - sandpaper.options
 - title: "[Internal] Post-build Aggregation Components"
   desc: >
     Components to build aggregate pages such as All in One and Keypoints
 - contents:
   - read_all_html
   - provision_extra_template
   - get_content
   - make_aio_section
   - make_images_section
   - build_agg_page
 - title: "[Internal] Resource Discovery/Management"
   desc: >
     Tools for discovering resources and managing their hashes in a text file
     database.
 - contents:
   - build_status
   - get_built_db
   - get_hash
   - get_resource_list
   - template_episode
   - yaml_list
 - title: "[Developer] Lesson Test Fixture"
   desc: >
     Internal documentation for the temporary lesson and remote used as a test
     fixture created and destroyed before and after tests.
 - contents:
   - create_test_lesson

articles:
 - title: "How to..."
   navbar: ~
   contents:
    - building-with-renv
    - automated-pull-requests
 - title: "Developer Guides"
   contents:
    - articles/landscape
    - articles/deployment
    - articles/toolchain
 - title: "In Progress"
   contents:
   - articles/internationalisation