|
50 | 50 | "id": "0b71025a-455d-4cd7-a196-6ebd5cc4f519", |
51 | 51 | "metadata": {}, |
52 | 52 | "source": [ |
53 | | - "## Migrating From fastpages\n", |
| 53 | + "## Migrating from fastpages\n", |
54 | 54 | "\n", |
55 | 55 | "If you previously had a fastpages site, we offer some utilities to help migrate you to Quarto. **The migration is not holistic: you will likely have to manually correct some things that we are not able to automate.**\n", |
56 | 56 | "\n", |
|
136 | 136 | "id": "3f00ffc1-295a-4de5-b71f-92cde47d3a84", |
137 | 137 | "metadata": {}, |
138 | 138 | "source": [ |
139 | | - "### Configuration Options: fastpages vs. Quarto\n", |
| 139 | + "### Configuration options: fastpages vs. Quarto\n", |
140 | 140 | "\n", |
141 | 141 | "fastpages (which was based on Jekyll) and Quarto offer different kinds of options and configurations for individual posts and at a site level. Below are some tables that organize some of the most important features of fastpages and how it maps to Quarto. Each link in the last column is specific to the relevant feature.\n", |
142 | 142 | "\n", |
143 | | - "#### Post Level Front Matter\n", |
| 143 | + "#### Post-level options\n", |
144 | 144 | "\n", |
145 | 145 | "Jekyll Front Matter | Quarto | Notes\n", |
146 | 146 | "-- | -- | --\n", |
|
158 | 158 | "\n", |
159 | 159 | "\n", |
160 | 160 | "\n", |
161 | | - "#### Site Level Options\n", |
| 161 | + "#### Site-level options\n", |
162 | 162 | "\n", |
163 | 163 | "Jekyll site config | Quarto | Notes\n", |
164 | 164 | "-- | -- | --\n", |
|
181 | 181 | "id": "8ee5b80e-7931-4d03-8f3e-c8010c36279c", |
182 | 182 | "metadata": {}, |
183 | 183 | "source": [ |
184 | | - "## Publishing Your Blog\n", |
| 184 | + "## Publishing your blog\n", |
185 | 185 | "\n", |
186 | 186 | "::: {.callout-warning}\n", |
187 | 187 | "_This section is for stand-alone blogs that are not part of a nbdev documentation site. If you want to create a blog within a nbdev documentation site, see [this section](#creating-a-blog-within-a-nbdev-project)._\n", |
|
198 | 198 | ":::\n", |
199 | 199 | "\n", |
200 | 200 | "\n", |
201 | | - "## Creating A Blog Within A nbdev Project\n", |
| 201 | + "## Creating a blog within a nbdev project\n", |
202 | 202 | "\n", |
203 | 203 | "In addition to a stand-alone blog that you might build with Quarto, you might want to include a blogging site in your nbdev project. This website has [a blog](../blog/) as well! The easiest way to implement a blog is to emulate the directory structure of [this folder](https://github.com/fastai/nbdev/tree/master/nbs/blog). The general steps are:\n", |
204 | 204 | "\n", |
|
243 | 243 | "5. **Create your first blog post**: You can emulate our example or create your own. In each folder, create a `index.qmd` or `index.ipynb` file. You can also put images and related assets in the same folder.\n", |
244 | 244 | "\n", |
245 | 245 | "\n", |
246 | | - "### Folder Structure\n", |
| 246 | + "### Folder structure\n", |
247 | 247 | "\n", |
248 | 248 | "Below is an overview of the general folder structure for a blog within a nbdev site:\n", |
249 | 249 | "\n", |
|
267 | 267 | "- `posts/`: this a subdirectory for each blog post.\n", |
268 | 268 | "- `YYYY-MM-DD-.../index.{qmd,ipynb}`: this is where you author the content of each individual blog post.\n", |
269 | 269 | "\n", |
270 | | - "### Special Considerations For nbdev blogs\n", |
| 270 | + "### Special considerations for nbdev blogs\n", |
271 | 271 | "\n", |
272 | 272 | "In contrast to standalone Quarto blogs, when you embed a blog in a nbdev website there are the following differences:\n", |
273 | 273 | "\n", |
|
280 | 280 | "id": "700589e2-aca4-44a4-b82d-167f63f55758", |
281 | 281 | "metadata": {}, |
282 | 282 | "source": [ |
283 | | - "## Using nbdev Features in Blogs Outside nbdev Projects\n", |
| 283 | + "## Using nbdev features in blogs outside nbdev projects\n", |
284 | 284 | "\n", |
285 | 285 | "::: {.callout-warning}\n", |
286 | 286 | "_This section is for stand-alone blogs that are not part of a nbdev documentation site. If you create a blog within a nbdev documentation site, all nbdev features will automatically work._\n", |
|
0 commit comments