For pull

[tao-guo]

With these two changes, generated site can even be opened locally from index.html.

[DonDebonair]

According to the 3.3.0 docs, TAGS_URL and CATEGORIES_URL have defaults already. However, according to the latest docs those settings don't exist anymore, and it's actually advised to put the urls hardcoded in the theme. I'm not sure yet what to do with this.

Regarding the second commit: This shouldn't be necessary. If you run make serve and the SITEURL is properly set (SITEURL = 'http://localhost:8000') then the link will work. It does with me, anyways :)

[DonDebonair]

Also, please split different issues in different PRs, on different branches :)

[magnunleno]

Actually Pelican 3.3.0 has a bug that TAGS_URL and CATEGORIES_URL doesn't honor it's default value. I've opened an issue recently: getpelican/pelican#1216

This PR is valid but not for long term. Maybe is better to keep an alert in the README telling to force the TAGS_URL and CATEGORIES_URL in the pelican.conf until the next pelican release.

[DonDebonair]

Actually, CATEGORIES_URL and TAGS_URL are both gone from the latest Pelican docs. TAGS_URL was still present in the 3.3.0 version. See this issue I created: getpelican/pelican#1225

[magnunleno]

There is something really strange going on. The issue I linked before was closed by a pull request to pelican's master branch. Let's wait the response from your issue.

[justinmayer]

@magnunleno: It's not that mysterious. Your issue was closed automatically by the pull request that fixed it. Then, a subsequent PR reverted that fix. We'll sort it out in the issue Daan filed.

[magnunleno]

@justinmayer Thanks!

[hlapp]

@tao-guo see pull request #15 and issue #14. This has already been fixed.

[tao-guo]

Thanks for the replies. What I mean is another issue: I was always opening the index.html local file with firefox/chrome directly, and I would get a well organized website even without any httpd server. To make it work,
I also set SITEURL to be empty and RELATIVE_URLS to be true. I am not sure if it is a normal case for most people, but it seems a good way for me to organize my local documents.

Thanks,
-Tao

[hlapp]

@tao-guo a lot of the bootstrap theme won't work if not serving over HTTP, due to JavaScript. If you want something that works for file:// access, have you looked at the simple theme built into Pelican?

[tao-guo]

Yes, the "simple" theme has the same issue. It will get "directory list" mode when clicking site link. Anyway it is not a big problem, maybe you can just ignore it.

Thanks,
-Tao

[DonDebonair]

The TAGS_URL and CATEGORIES_URL is something that needs to be looked at, but it depends on the aforementioned Pelican issue. The rest I won't merge, because its not an issue IMHO :)