dondebonair / pelican-bootstrap3 Goto Github PK

Hi :), happy new year

Great work on this template. We plan to use it for the new Spyder website, and during this process I came up with some ides for improvements.

Menu active element generation
The current navbar does not create the "active" class for links defined on the MENUITEMS.

Base template
I like your template a lot, but not everyone is just making blogs and I think is good that Pelican leaves that area of only for blogs... Even if it is not offered as such, everything in Pelican is leaning towards a Blog.

For our use case the blog is just one section with other features/dowbnloads/documentation pages that follow a different look, so in this way I refactored the base templates so that the sidebar is not enforced from there, but only in the other pages. I understand there might some "code duplication" but this would leave more freedom for use in non blogging sites.

The idea is that the base template has only a block for the actual body content, whatever it might be, and then the other pages defined either a sidebar (blogs, articles) or a features set page that is different.

Just wanted to share some thoughts

Cheers!

While the avatar icon works fine on the main articles it does not work on anything in the 'pages' folder due to the relative pathing of the file. These pages are generated as /pages/page.html so 'resources/site/avatar.png' is not in a valid location for the rendered pages.

The current code for Tipue search require rewrite rule to work properly.

<form class="navbar-search" action="/search">

In some web host where rewrite rule is not supported (e.g. S3, CloudFiles) the search feature will not be able to function correctly.
Wouldn't it be better to post search data to html file directly?

<form class="navbar-search" action="/search.html">

The focus here is to have a working out-of-box default configuration rather than supporting every different use case.

Daan, I went through installing everything, and used your github repo bootstrap3 theme, but I am getting an error when trying the use liquid tags for inserting ipython notebook. The img liquid tag works but not the notebook

Here is the info for the site on my configuration
https://github.com/nagordon/testsite4/blob/master/content/test_entry.md

Your theme is awesome BTW

Thoughts?

templates/base.html directly links non-minified jquery from http://code.jquery.com/jquery.js

Is there something preventing you to include minified jquery in static js files?

I created a pull request from my fork if you'd like to change it.

Not sure if this is the best place to ask, but...
I'm using this nice theme here http://cranmer.github.io but a couple of issues:

• how did you add those twitter, google+, facebook sharing things at the bottom of the post in your website and the screenshot example.
• how can I refer to the font that is being used? I have some widget that sets a font via: rssmikle_font="Verdana, fontawesome-webfont,Arial, Helvetica, sans-serif"; but it does't match the font of the theme. I tried to add fontawesome-webfont, to no avail.

Would it be possible to add a setting that displayed the social links in a minimal format?
Basically add a flag to enable this:

DISPLAY_SOCIAL_MINIMAL = True

1. Remove the "Social" heading
2. Remove the label for each of the social buttons.
3. Display all the buttons on the same line rather than in a list?

I am new to pelican, and I am trying to follow the directions on your site to install the disqus commenting system. When I follow your instructions, I get the following error message: "We were unable to load Disqus. If you are a moderator please see our troubleshooting guide."

I then tried to use the disqus_static plugin to no avail either. I tried Isso, but the requirement to understand database management thwarted my more open-source intentions.

I found this blog post (http://www.blog.talkigy.com/get_disqus-to-work-with-pelican.html), but the suggested fix did not help.

This blog also referenced the troubleshooting disqus site (https://help.disqus.com/customer/portal/articles/472007-i-m-receiving-the-message-%22we-were-unable-to-load-disqus-%22), but the various templates you have beautifully created seem a bit too difficult for me to alter effectively.

But maybe I am just not understanding what you mean by this: "You can also enable Disqus comments for pages. This is a per-page setting you can control by adding a field comments to you pages' metadata. Set it to enabled to enable comments for that page. Comment-threads for pages will have an id that is prefixed by 'page-'."

Any ideas/suggestions/references would be appreciated!

http://www.charlie-marshak.net/hi.html

I just started playing with the table rendering and am getting some funky output:

Here's an example: http://crunk.io/understanding-ejuice-and-branching-out.html

The tables are rendering, but are not formatted in an aesthetically pleasing way.

I'm not good with webdev in generally, but looking at the bootstrap table examples here, I'm curious if there is a way to make them render in any of these styles?

The tables are written in markdown, here's the source that beings rendered.

I'm not sure but there shoud be (base.html line 134):

<form class="navbar-search" action="/search.html">
not
<form class="navbar-search" action="/search">

Or i have somthing wronk with conf?

Without this modofication - searching redirect to page which do not exist.

when I write some code in markdown file and use pygments to highlight the code , if the line of code is too long the side bar on the right side will flat over the highlight code snippet , could you guys help me with that?

PS:I just follow the quick start instructions on the pelican website and paste the pelicanconf.py's content to the markdown file.

The mathjax URL was apparently not a stable one. I fixed it by changing the url in liquid_tags_nb_header. Try this.
<script src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" type="text/javascript"></script>

I'm confused, in my pelicanconf.py I have:

SOCIAL = (...,          ('flickr','http://www.flickr.com/photos/hoonynoo/'), ...

and in the pelican-bootstrap3/templates/includes/sidebar.html I see:

  <li class="list-group-item"><a href="{{ link }}"><i
                            class="fa fa-{{ name|lower|replace('+','-plus') }}-square fa-lg"></i> {{ name }}
               </a></li>

I also see the fa-flickr font,
http://fortawesome.github.io/Font-Awesome/icon/flickr/

so I'm not sure why it's not showing up. Example:
http://theoryandpractice.org

In general, the html4css1.css stylesheet should be included along the rest of the css as documented in this page.

Probably this is at worst harmless, because this stylesheet is mostly concerned with docutils specific classes so it doesn't overlap with more general css theming.

A simple example in which you can appreciate the difference between including and not including this file:

i.  first item
ii. second item

The specified behavior is that the generated list must show the correct (roman) numeration style.

Hello.

TYPOGRIFY options is do not work

See discussion in #48

I'm not sure of the reasons, but the Font Awesome files included in the theme (specifically the .ttf and .woff files) result in a broken pipe exception with Pelican's simple HTTP server for local development.

I suspect most people will want comment counts on the index (and possibly other pages) if they have Disqus-powered comments enabled. Presently that requires uncommenting code in a template page. For one, that is more technical than it should or needs to be.

Moreover, every requirement to uncomment template page content to get a feature causes a fork to permanently diverge from the main (upstream) repo's master branch, which in turn makes submitting clean pull requests (i.e., pull requests that don't contain the diverging commits) an increasing hassle.

So ideally, there is no need to ever uncomment - everything is controlled by config variables. The next best thing is that at least features more commonly desired or useful be controlled by config variables and not commenting/uncommenting.

I suggest some improvements for AddThis plugin:

• Possibility to disable data_track_addressbar. This function add some hashtag to the end of URL so it is not clean. I don't like it. I wanna clean URL. Example of polluted URL: http://example.com/my-article#.Uw0v1oVK0uh.
• Possibility to enable/disable Facebook, Twitter, Google+.

I am getting the following error

CRITICAL: (u"[templates] unable to load article-full.html from [u'/pelican-bootstrap3/templates']",)
CRITICAL: [templates] unable to load article-full.html from [u'/pelican-bootstrap3/templates']

in my pelicanconf.py, I have

%#Theme
THEME = 'pelican-bootstrap3'
BOOTSTRAP_THEME = 'solarizedlight'
PYGMENTS_STYLE = 'solarizeddark'
FAVICON = '/favicon.ico'

and I don't know why it looks for article-full.html.

I appreciate any comment

Blog content is creative expression and thus protected by copyright. The footer currently asserts copyright, but leaves terms of reuse or license for visitors in the dark. Recommended practice is to expressly declare a license under which the content can be reused. Right now this requires modifying the footer by hand; ideally this would be configurable.

Hi,

I really like your theme. However, for better readability I would like to be able to adjust the width of the central "content" column for Desktop systems. I would prefer to define the width to be fixed by number of symbols (say max 100 -> content driven) rather than to be relative to the screen size (hardware driven).

What would be an 'easy' way to do this?

While having Bootstrap CSS&JS bundled with the theme eases local development, it is suboptimal for a variety of reasons:

• Files are less unlikely to be in the browser cache
• Files are unlikely to be close to the user
• Certain popular hosting options (eg Amazon S3) don't compress files making the site slow on mobile
• On custom hosting this consumes bandwidth

In my case, these files represent most of the weight of what a client has to fetch.

I would like to add a boolean option that when set to True make ressources be fetched from well-established CDN:

• Bootstrap, Fontawesome and themes from bootstrapcdn.com/
• jQuery from Google Hosted Libraries

One could then set this boolean to True in publishconf.py to decrease cost and improve performances on the production site.
Is it something you'd accept to merge?

Hello ! I tried the option DISQUS_DISPLAY_COUNTS = True and spotted a small bug.
When there is 0 comment, it displays : "There are comments" :) Quite misleading.
Also when you delete a comment, it is not updated on the index page.
You can see the bugs on my page http://9lives.me

If somebody also have a trick for the search form. It's stuck to the top :/

Thanks in advance !

I have a very short post - a couple of lines - and the ABOUT_ME enabled including an AVATAR. Consequently, the total height of the about me section is actually larger than the entire height of the post inside the .col-sm-9 class. With nothing in the .col-sm-9 class on its left to keep it justified right, the sidebar actually ends up justified left directly below the post content.

I hacked together a very kludgy bit of js to add extra padding to the .col-em-9 class, but I highly doubt that's a good way of permanently solving this problem (so I won't be submitting a pull request).

Hi, great work with this template :)

Just wondering if you should include in the docs also the existence of

CATEGORIES_URL 
TAGS_URL

https://github.com/DandyDev/pelican-bootstrap3/blob/master/templates/includes/sidebar.html

I see that they were not defined so clicking on the sidebar Tags or Category leads does not lead to the place where they should be stored...

I'd like to use Fontawesome icons in article titles, so I added this bit of code to the beginning of the title, like so:

title: <i class="icon-circle-arrow-up" style="color:red;"></i>Things are looking up

The article has a category and is also tagged.

On the Category, Tag and Archive pages the icon appears as expected: a red circle/up arrow before black text. On the individual post's page, however, it's screwy.

In the body of the page, before the Title, it shows this:

Things are looking up"/>

The entire title is red and shows this:

Things are looking up"/>[icon]Things are looking up

Does anybody know if it is possible to limit the number of lines on the index page per post?

Maybe this was omitted on purpose but it would be great to include by default the template to handle

├── period_archives.html // to display time-period archives

as triggered by these settings in pelican

YEAR_ARCHIVE_SAVE_AS = 'posts/{date:%Y}/index.html'
MONTH_ARCHIVE_SAVE_AS = 'posts/{date:%Y}/{date:%b}/index.html'

The default theme has a variable called SITESUBTITLE that lets you add a sentence in the header after the SITENAME. Any chance this could be added to this theme?

Hi again :)

On the test site I am using pretty urls and pagination patterns, so...

CATEGORIES_URL =  'categories/' 
CATEGORY_URL = 'categories/{slug}/'
CATEGORY_SAVE_AS = '{0}index.html'.format(CATEGORY_URL)
CATEGORIES_SAVE_AS = 'categories/index.html'

TAGS_URL = 'tags/'  
TAG_URL = 'tags/{slug}/'
TAG_SAVE_AS = '{0}index.html'.format(TAG_URL)
TAGS_SAVE_AS = 'tags/index.html'

PAGINATION_PATTERNS = (
    (1, '{base_name}/', '{base_name}/index.html'),
    (2, '{base_name}/page/{number}/', '{base_name}/page/{number}/index.html'),
)

And well, pagination under this circumstances is breaking up for categories and tags, the links in the page numbers on the bottom lead to wrong not existing urls.

While I think of a fix on the template I reverted to using th epager (older ...newer)

Cheers

I didn't want to have my sitename on the banner, by default it would be too big and repetitive. But i did like the more subdued subtitle style. It could just be changed in css, but I like the flexibility I added. I understand if you feel otherwise.

What I did was update the banner template be like this:

    {% if BANNER_TITLE_FLAG %}
        <h1>
            {{ BANNER_TITLE }}
        </h1>
    {% endif %}
    {% if BANNER_SUBTITLE %}
        <p class="intro" style='margin-bottom:0px; margin-left:0px;'>
            {{ BANNER_SUBTITLE }}
        </p>
    {% endif %}

I don't know much about jinja2 variables so not sure if we could get away with just having BANNER_TITLE. If it is not set would it return False?

You might also noticed I changed the intro class margin here, not sure where else it is used but it was bothering me in the banner.

This may be a result of the migration to Bootstrap3, but the breakpoint for the columns to stack is now at "large desktop", which for example even exceeds the default width of a Chrome window on a modern laptop. In reality there is more than enough horizontal space for having articles and sidebar side-by-side even on a tablet. In Bootstrap3 parlance, this is "sm", not "lg". Grids for smaller devices scale up seamlessly, but not the other way around.

Hi. I am not sure if this is the best place to post this but my Disqus comments are not working for my personal blog-- www.santoshsankar.com.

I put my shortname into the pelicanconf.py file and looking at the template, it looks like it should work. Any reason it does not work? Happy to go to a resource that can help me address it-- sorry for posting here but did not know where else to go. Google searches yielded no results.

I just quickly set up a site today and decided to use your theme: http://crunk.io/pelican-quickstart.html

The line numbers on the codeblocks aren't wide enough - any any codeblock with double digits is broken. Any ideas?

The article slug need not be unique within a site.

Shouldn't the items in the side bar be grouped in separated lists? This can easy customization and help adding new styles to the sidebar.

I cannot get the WhatsApp icon to show when it is enabled in shariff.

I don't have an example online to demostrate the issue, but as an reference from @krid78 (#163), I cannot see the whatsapp icon there either: http://www.die-kriestens.de/articles/shariff-und-pelicanboostrap3.html

This is what it should look like: http://heiseonline.github.io/shariff/

https://github.com/DandyDev/pelican-bootstrap3/blob/master/templates/base.html#L5

Will result in

<!DOCTYPE html>
<html lang="en"
>

As many other fields of the Open Graph protocol are supported, it would be nice to include the author/authors

I would like my website to load even faster, and it seems that addthis.js takes up some time. I would like to disable this feature, so I went to pelicanconf.py and I commented the two lines:

ADDTHIS_PROFILE = 'ra-548e3c553a19ddf3'
ADDTHIS_DATA_TRACK_ADDRESSBAR = False

However, after make html the websites still loads addthisplugin. Any ideas how can I disable it ?

That's because the default setting for SITEURL is the empty string, which works correctly for serving up a local dev version of the site.

Is it possible to add a list of recent posts on the sidebar?

Thanks!

Hi, I recently ran into a problem where the opengraph summary would be displayed at the top of the page, breaking out of the meta tag that it was described in.

This was due to a code example containing a tag in the initial part of the post. This did not get cleard by Jinja's |striptags statement. I fixed this locally by adding an additional |escape after it, though I'm not sure that's the ideal approach.

A cursory glance at the code seems to show that this is the only place where the summary is used other than the index page, where html is expected.

Can
var disqus_identifier = '{{ article.date|strftime('%Y-%m-') ~ article.slug if DISQUS_ID_PREFIX_SLUG else article.slug }}';
be changed to article.xxx or page.xxx?

and
page.html
{% include 'includes/comments.html' %}

Maybe gate this with a config option?

The footnote/citation back links at the bottom of the page are not visible for rst documents.

I think this is because docutils sets the label class and bootstrap doesn't play well with it.

<link href="{{ SITEURL }}/{{ FEED_ALL_RSS }}" type="application/atom+xml"

for RSS, type should be application/rss+xml not application/atom+xml