Pre-publication pass #3

Merged
caribaud merged 6 commits from pre-publication into main 2025-06-01 18:36:16 +02:00
Owner

Adding entry about transcripts
Adding entry about background picture
Adding many missing screenshots

Adding entry about transcripts Adding entry about background picture Adding many missing screenshots
caribaud added 1 commit 2025-06-01 16:09:11 +02:00
5a23a008f1 Pre-publication pass
Adding entry about transcripts
Adding entry about background picture
Adding many missing screenshots
caribaud requested review from aaribaud 2025-06-01 16:09:30 +02:00
aaribaud requested changes 2025-06-01 16:32:41 +02:00
Dismissed
aaribaud left a comment
Collaborator

See detailed comments.

Also: maybe not store Kate swap files in a commit?

(see https://git.aribaud.net/caribaud/silicate_guide/pulls/3/files#diff-f8bae4d709f3140f4ca93935d797b81d92b20ba1)

See detailed comments. Also: maybe not store Kate swap files in a commit? (see https://git.aribaud.net/caribaud/silicate_guide/pulls/3/files#diff-f8bae4d709f3140f4ca93935d797b81d92b20ba1)
@ -0,0 +69,4 @@
E01P01.jpg
```
Now, you can navigate to `https://localhost:1313/about/` and you should see the about page:
Collaborator

Next para also starts with 'now', maybe reformulate

Next para also starts with 'now', maybe reformulate
aaribaud marked this conversation as resolved
@ -0,0 +123,4 @@
* `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
Collaborator

Sentence is broken

Sentence is broken
aaribaud marked this conversation as resolved
Collaborator

This warning was removed but no link was added in its place. Normal?

This warning was removed but no link was added in its place. Normal?
Author
Owner

Yes, it was to warn about the page being constructed, not a missing image

Yes, it was to warn about the page being constructed, not a missing image
aaribaud marked this conversation as resolved
@ -34,0 +35,4 @@
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:
Collaborator

a -> an ?

a -> an ?
aaribaud marked this conversation as resolved
@ -36,2 +54,4 @@
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.
Collaborator

Missing comma after "that is"

Missing comma after "that is"
aaribaud marked this conversation as resolved
@ -38,0 +73,4 @@
> 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
Collaborator

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

"to check there is no problem" => "to check if there are problems"
aaribaud marked this conversation as resolved
@ -38,0 +74,4 @@
> 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.
Collaborator

"refuse" => "refuses"

"refuse" => "refuses"
aaribaud marked this conversation as resolved
@ -49,2 +88,3 @@
This `index.md` file tells Hugo that the `E01P01` folder is a page and that all other
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.
Collaborator

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

"from you may" => "from you, and you may"
aaribaud marked this conversation as resolved
@ -107,2 +145,3 @@
The `weight` attribute will be explained in [Page ordering](#page-ordering).
![Page without picture](page_without_picture.jpg)
That's a start, but that's... not great, because there is no pictures yet.
Collaborator

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

"there is no" => "there are no"
aaribaud marked this conversation as resolved
@ -113,2 +155,3 @@
To fix this, all we need are pictures for the comic page.
Create a `strips/` folder inside `E01P01/`
That warning is a bit of a mouthful, what it means is: "Silicate want pictures inside
Collaborator

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?
aaribaud marked this conversation as resolved
@ -216,0 +261,4 @@
### Transcript
Some webcomics provides transcripts of their pages. Adding one to yours is
Collaborator

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"
aaribaud marked this conversation as resolved
@ -216,0 +273,4 @@
```
Pepper the witch prepares a potion in a cauldron
while her cat Carrot lasily looks at her.
Collaborator

lazily

lazily
aaribaud marked this conversation as resolved
@ -216,4 +318,4 @@
## Recap
Now you have most of what you need to have a simple webcomic!
Collaborator

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

"what you need to have a" => what you need for a"
aaribaud marked this conversation as resolved
@ -220,2 +322,3 @@
You can just keep adding new pages!
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.
Collaborator

vave => has

vave => has
aaribaud marked this conversation as resolved
@ -226,5 +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`.
Collaborator

transcript => transcripts

transcript => transcripts
aaribaud marked this conversation as resolved
@ -0,0 +12,4 @@
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.
Collaborator

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

the first one it finds => the first one in alphabetical order
aaribaud marked this conversation as resolved
@ -0,0 +1,3 @@
<div style="text-align:center">
Collaborator

This is exactly the same as center-no-frame.html. Is this normal?

This is exactly the same as center-no-frame.html. Is this normal?
Author
Owner

Nope, should have removed center-no-frame

Nope, should have removed center-no-frame
aaribaud marked this conversation as resolved
caribaud added 2 commits 2025-06-01 18:03:19 +02:00
caribaud referenced this issue from a commit 2025-06-01 18:16:44 +02:00
caribaud added 1 commit 2025-06-01 18:16:45 +02:00
caribaud requested review from aaribaud 2025-06-01 18:17:11 +02:00
caribaud added 1 commit 2025-06-01 18:25:26 +02:00
Author
Owner

Archives added.

When will you add git LFS? :)

Archives added. When will you add git LFS? :)
caribaud added 1 commit 2025-06-01 18:27:33 +02:00
aaribaud approved these changes 2025-06-01 18:34:37 +02:00
caribaud merged commit 863b08afc8 into main 2025-06-01 18:36:16 +02:00
caribaud deleted branch pre-publication 2025-06-01 18:36:16 +02:00
Sign in to join this conversation.
No reviewers
No Milestone
No project
No Assignees
2 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: silicate/silicate-guide#3
No description provided.