Pre-publication pass #3

Merged
caribaud merged 6 commits from pre-publication into main 2025-06-01 18:36:16 +02:00
5 changed files with 19 additions and 21 deletions
Showing only changes of commit 121837931f - Show all commits

1
.gitignore vendored
View File

@ -3,3 +3,4 @@ static/Shrines.png
hugo
_gen
*.lock
*.kate-swp

View File

@ -69,7 +69,7 @@ my_webcomic/
E01P01.jpg
```
Now, you can navigate to `https://localhost:1313/about/` and you should see the about page:
You can navigate to `https://localhost:1313/about/` and you should see the about page:
aaribaud marked this conversation as resolved Outdated

Next para also starts with 'now', maybe reformulate

Next para also starts with 'now', maybe reformulate
![About page](about_page.jpg)
@ -123,7 +123,7 @@ Now, we can add our own About page entry inside the `[menus]` table:
* `name` is what is displayed in the nav
* `pageRef` is what page should be displayed, relative to the
`content/` folder
* `weight` is the sorting the menu entries just like we saw for pages
* `weight` is for sorting the menu entries just like we saw for pages
aaribaud marked this conversation as resolved Outdated

Sentence is broken

Sentence is broken
Be careful, we need `[[menus.main]]` and **not** `[menus.main]`.

View File

@ -35,7 +35,7 @@ Now, we need to tell Silicate the title of the comic and give it a description.
It will be used in the archive.
Let's create a `_index.md` (notice the leading `_`) file inside `my_website/content/` with the following content:
Let's create an `_index.md` (notice the leading `_`) file inside `my_website/content/` with the following content:
aaribaud marked this conversation as resolved Outdated

a -> an ?

a -> an ?
```
+++
@ -54,7 +54,7 @@ so you can have some simple styling, like *\*italic text\**, **\*\*bold text\*\*
Full description of Markdown possibilities will be added later.
{{< /warning >}}
This `_index.md` file tells Hugo that this folder is a *section*, that is a group of pages.
This `_index.md` file tells Hugo that this folder is a *section*, that is, a group of pages.
aaribaud marked this conversation as resolved Outdated

Missing comma after "that is"

Missing comma after "that is"
Now, you should have this:
@ -73,8 +73,8 @@ it is used to add attributes to a page or a section, such as its title.
> The terminal just told me `ERROR Section '/comic' contains no pages!`!
That's normal: Silicate tries to check there is no problem when building your website
and refuse to do so when there is an obious problem.
That's normal: Silicate tries to check if there are problems when building your website
aaribaud marked this conversation as resolved Outdated

"to check there is no problem" => "to check if there are problems"

"to check there is no problem" => "to check if there are problems"
and refuses to do so when there is an obious problem.
aaribaud marked this conversation as resolved Outdated

"refuse" => "refuses"

"refuse" => "refuses"
To fix it, let's add the first page from Pepper & Carrot!
@ -87,7 +87,7 @@ because this folder name will be used as a URL for this page).
Then create a text file named `index.md`, without a leading `_` this time.
If you are on Windows, make sure the file created isn't
`index.md.txt`; Windows likes to hide file extensions from you may need to force windows to display them.
`index.md.txt`; Windows likes to hide file extensions from you, and you may need to force windows to display them.
aaribaud marked this conversation as resolved Outdated

"from you may" => "from you, and you may"

"from you may" => "from you, and you may"
This `index.md` file tells Hugo that the `E01P01` folder is a page -- not a section -- and that all other
files inside this folder belong to this page. This is what Hugo calls a "Page Bundle".
@ -144,19 +144,19 @@ And now, if we look at the website, we see this!:
![Page without picture](page_without_picture.jpg)
That's a start, but that's... not great, because there is no pictures yet.
That's a start, but that's... not great, because there are no pictures yet.
aaribaud marked this conversation as resolved Outdated

"there is no" => "there are no"

"there is no" => "there are no"
The terminal also warned us about that:
`WARN The comic page '/comic/e01p01' has no image matching the strips/**.{png,jpg,webp,PNG,JPG,WEBP} pattern!`
That warning is a bit of a mouthful, what it means is: "Silicate want pictures inside
a 'strips/' folder"
### Comic pictures
aaribaud marked this conversation as resolved Outdated

Shouldn't this paragraph about the warning move before the "To fix this" one?

Shouldn't this paragraph about the warning move before the "To fix this" one?
To fix this, all we need are pictures for the comic page.
That warning is a bit of a mouthful, what it means is: "Silicate want pictures inside
a 'strips/' folder"
So let's create a `strips/` folder inside `E01P01/`
Get the `pages/E01P01.jpg` file from the resources you downloaded -- or your
@ -261,8 +261,8 @@ Now, the page should be displayed with a creation date under its title!:
### Transcript
Some webcomics provides transcripts of their pages. Adding one to yours is
very simple: add a `transcript.md` text file next to your `index.md` and
Some webcomics provides transcripts of their pages. Adding a transcript to a comic page
aaribaud marked this conversation as resolved Outdated

999 Too Many Pronouns

"Adding one to yours" => "Adding a transcript to a comic page in Silicate"

999 Too Many Pronouns "Adding one to yours" => "Adding a transcript to a comic page in Silicate"
in Silicate is very simple: add a `transcript.md` text file next to your `index.md` and
Silicate will automatically add a "Transcript" button to display or
hide the content of `transcript.md` under your page.
@ -273,7 +273,7 @@ For the first page, let's write a small transcript:
```
Pepper the witch prepares a potion in a cauldron
while her cat Carrot lasily looks at her.
while her cat Carrot lazily looks at her.
aaribaud marked this conversation as resolved Outdated

lazily

lazily
She sprinkles some powder in the cauldron.
@ -318,10 +318,10 @@ It will show the comic title and its description.
## Recap
Now you have most of what you need to have a simple webcomic!
Now you have most of what you need for a simple webcomic!
aaribaud marked this conversation as resolved Outdated

"what you need to have a" => what you need for a"

"what you need to have a" => what you need for a"
You can just keep adding new pages! The resource archive you downloaded
have what you need to add the first three pages of Pepper & Carrot.
has what you need to add the first three pages of Pepper & Carrot.
aaribaud marked this conversation as resolved Outdated

vave => has

vave => has
Here's what to remember:
@ -329,6 +329,6 @@ Here's what to remember:
* Comic pages go inside `content/comic/`.
* Comic pages are folders with an `index.md` file.
* Comic page pictures go into a `strips/` sub-folder.
* Comic page transcript go into a `transcript.md` file next to `index.md`.
* Comic page transcripts go into a `transcript.md` file next to `index.md`.
aaribaud marked this conversation as resolved Outdated

transcript => transcripts

transcript => transcripts
* `index.md` has a *front matter* to set its title, ordering and creation date.
* Ordering is done through weights. Light/Small = first, heavy/big = last.

View File

@ -12,7 +12,7 @@ Simply create a `background/` folder inside that and put
in there any JPG, PNG or WEBP you want!
Note that if you put multiple pictures in there,
Silicate will take the first one it finds.
Silicate will take the first one in alphabetical order.
aaribaud marked this conversation as resolved Outdated

the first one it finds => the first one in alphabetical order

the first one it finds => the first one in alphabetical order
For example, if you downloaded the resource archive
from the [Getting started tutorials]({{% relRef "tutorials/getting-started/new-comic-and-pages/" %}}),

View File

@ -1,3 +0,0 @@
<div style="text-align:center">
{{ .InnerDeindent | .Page.RenderString }}
</div>