How should I add pages to my Hugo-website?

support
,
1

Hello guys!
The problem is: only the index.md page renders by Hugo, other created by me .md-pages do not transforms to the .html-files.
What should I do in this case?
URL os my web-site is https://splash.org.ru/ :slight_smile:

dragonserw@debian-SerW:~/hugo/splash-org-ru$ cd ./content/ru && tree
.
├── about.md
├── contact-us.md
├── index.md
└── post
    ├── bookmark.md
    └── radio.md

2 directories, 5 files
dragonserw@debian-SerW:~/hugo/splash-org-ru/content/ru$ cd
dragonserw@debian-SerW:~$ cd $HOME/hugo/splash-org-ru && hugo env
hugo v0.111.3+extended linux/amd64 BuildDate=2023-03-16T08:41:31Z VendorInfo=debian:0.111.3-1
GOOS="linux"
GOARCH="amd64"
GOVERSION="go1.19.6"
github.com/sass/libsass="3.6.5"
github.com/webmproject/libwebp="v1.2.4"
dragonserw@debian-SerW:~/hugo/splash-org-ru$
2

Rename content/index.md to content/_index.md. The underscore makes all the difference.

To understand why, please read:

3

Thank you dear man, frjo!

dragonserw@debian-SerW:~$ tree $HOME/hugo/splash-org-ru/content
/home/dragonserw/hugo/splash-org-ru/content
├── en
│   ├── about
│   │   └── _index.md
│   ├── contact-us
│   │   └── _index.md
│   ├── index
│   │   └── _index.md
│   ├── post
│   │   ├── bookmark.md
│   │   └── radio.md
│   └── privacypolicy
│       └── _index.md
└── ru
    ├── about
    │   └── _index.md
    ├── contact-us
    │   └── _index.md
    ├── index
    │   └── _index.md
    └── post
        ├── bookmark.md
        └── radio.md

12 directories, 11 files
dragonserw@debian-SerW:~$
4

You don’t have to convert every index.md to _index.md if it is not a branch bundle (list, section, etc).

5

@SerW That is not correct either. You need to read the documentation for “Page bundles” I linked to above one more time.

6

Hello one more time guys.
I do not understand clearly, what is written on that very page.
Does the changes I provide to you through the tee command are right?

dragonserw@debian-SerW:~$ tree $HOME/hugo/splash-org-ru/content
/home/dragonserw/hugo/splash-org-ru/content
├── en
│   ├── about.md
│   ├── contact-us.md
│   ├── index
│   │   └── _index.md
│   ├── post
│   │   ├── bookmark.md
│   │   └── radio.md
│   └── privacypolicy.md
└── ru
    ├── about.md
    ├── contact-us.md
    ├── index
    │   └── _index.md
    └── post
        ├── bookmark.md
        └── radio.md

7 directories, 11 files
dragonserw@debian-SerW:~$

And by the way, An annoying bug is about the index → _index renaming: as you can see in the screenshot of my website: https://splash.org.ru/~SerW/Temp/2023-10-26/splash.pdf, most of the text is Ctrl + E, I mean it is centered.
How can I disable that very bug? :slight_smile:

7 
content/
├── en/
│   ├── post/
│   │   ├── _index.md    <-- section page / branch bundle
│   │   ├── bookmark.md
│   │   └── radio.md
│   ├── _index.md        <-- home page
│   ├── about.md
│   └── contact-us.md
└── ru/
    ├── post/
    │   ├── _index.md    <-- section page / branch bundle
    │   ├── bookmark.md
    │   └── radio.md
    ├── _index.md        <-- home page
    ├── about.md
    └── contact-us.md
1 Like
8

I understand, thank you a lot!
Tomorrow I will add underscored index.md into /post :slight_smile:

9

Good day, Joe!
As I can see, you advice to me not to put the home page, _index.md into ~/index folder.
But if I do so, my home page is not displayed.

10

I suggest that you take some time to read the documentation and understand what pages and page bundles are about and when/if you use index.md vs. _index.md. As @frjo already pointed out:

Wildly adding and removing underscores is not getting you anywhere, as the rule is quite simple:

  • Use _index.md with anything that is a branch bundle, i.e. it can contain other pages
  • Use index.md with anything that is a leaf bundle, i.e. it does not contain other pages
1 Like
11

This topic was automatically closed 2 days after the last reply. New replies are no longer allowed.