doc discrepancy: getnikola.com isn't actually built as a site w blog.

[Blaise Pabon]

Is there a working "site with blog" I can use as a reference?

The tutorial for creating a site with a blog says to "see an example refer to the Nikola site" (code), but the current Nikola site doesn't have that structure of

INDEX_PATH="blog" 

POSTS = (

    ("posts/*.rst", "blog", "post.tmpl"),

    ("posts/*.txt", "blog", "post.tmpl"),

    ("posts/*.html", "blog", "post.tmpl"),

The other observation is that the example of the pages.index site says "By default Nikola uses reStructuredText but it supports a ton of formats,"

but the example includes mostly CSS and HTML directives, with none of the elements that would typically appear on a landing page.

The current symptom is illustrated in:

https://gitlab.com/blaisep/blaisep.gitlab.io/-/issues/1

I don't mind updating the docs, but I don't yet have a working example to contribute.

-Blaise

--

LinkedIn  |  Quora  |  Github

“If you want to go fast, go alone. If you want to go far, go together.” --African proverb 

[Roberto Alsina]

On Tue, Sep 13, 2022 at 1:02 PM Blaise Pabon <bla...@gmail.com> wrote:

Is there a working "site with blog" I can use as a reference?

The tutorial for creating a site with a blog says to "see an example refer to the Nikola site" (code), but the current Nikola site doesn't have that structure of

INDEX_PATH="blog" 

POSTS = (

    ("posts/*.rst", "blog", "post.tmpl"),

    ("posts/*.txt", "blog", "post.tmpl"),

    ("posts/*.html", "blog", "post.tmpl"),

This is the relevant fragment from nikola's site config:

POSTS = (

	("posts/*.txt", "blog", "post.tmpl"),
	("posts/*.rst", "blog", "post.tmpl"),

("posts/*.md", "blog", "post.tmpl"),

("posts/*.html", "blog", "post.tmpl"),

	)
	PAGES = (
	("stories/*.txt", "", "story.tmpl"),
	("stories/*.rst", "", "story.tmpl"),
	("stories/*.html", "", "story.tmpl"),
	) INDEX_PATH = "blog"

Sorry about the bad indenting, gmail sucks for this.

And it's exactly the same as described in the "site with a blog" section of the document, except for the name of a folder (stories instead of pages) and the name of a template (story.tmpl instead of page.tmpl)

 

The other observation is that the example of the pages.index site says "By default Nikola uses reStructuredText but it supports a ton of formats,"

but the example includes mostly CSS and HTML directives, with none of the elements that would typically appear on a landing page.

I am not sure what document you are referring to here.

 

The current symptom is illustrated in:

https://gitlab.com/blaisep/blaisep.gitlab.io/-/issues/1

I don't mind updating the docs, but I don't yet have a working example to contribute.

The usual template for posts is post.tmpl and for pages is page.tmpl

 

-Blaise

--

LinkedIn  |  Quora  |  Github

“If you want to go fast, go alone. If you want to go far, go together.” --African proverb 

--
You received this message because you are subscribed to the Google Groups "nikola-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to nikola-discus...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/nikola-discuss/CAJZwnxWQJy6XW0ERd_LiA3USYuYSAT6waz%2B%3DSFd_QAK3BrboQA%40mail.gmail.com.

[Blaise Pabon]

Thank you so much for the reality check.

After I get this working and figure out if any docs need updates.

Blaise.

To view this discussion on the web visit https://groups.google.com/d/msgid/nikola-discuss/CALXDAfosVLmeWX2emPqYtr%2BbV4gdg1t8y4%3D-QrFv1y3A_hGODA%40mail.gmail.com.