pelican-elegant / elegant Goto Github PK

Running a link checker reveals that a few icons could not be found (settings):

• http://tshepang.net/theme/images/apple-touch-icon-144x144.png
• http://tshepang.net/theme/images/apple-touch-icon-114x114.png
• http://tshepang.net/theme/images/apple-touch-icon-57x57.png
• http://tshepang.net/theme/images/apple-touch-icon-72x72.png
• http://tshepang.net/theme/images/apple-touch-icon.png
• http://tshepang.net/theme/images/favicon.ico

Code snippets normally appears as-is, else it's a mess:

(from bottom of http://tshepang.net/project-of-note-valgrind)

Show category feeds on categories page.
Show tag feeds on tags page.

Perhaps

#article img {
    padding:5px;
    border:1px solid #969696;
    background-color:#e1e1e1;

}

1. CSS should follow the style
2. Sensible defaults so that theme should work out of the box
3. Also update project documentation
4. User should not have to have use readability addons
5. Use muted colors

I added my Stack Exchange profile to SOCIAL collection, and I get this:

You can access this from any of my posts.

Wanted to confirm if anyone else gets this warning, and if it's anything I should care about:

$ pelican --settings settings.py
WARNING: sitemap plugin: SITEMAP['format'] must be `txt' or `xml'
WARNING: sitemap plugin: Setting SITEMAP['format'] on `xml'
Done: Processed 274 articles and 1 pages in 43.68 seconds.

Twitter Card. Twitter shows summary of links shared on it. How to do it so that links from sites using Elegant also get their summary shown.

makes more sense to me; at the moment they are sorted by name

compare http://demo-moment.tshepang.net/tag/#Python
with http://tshepang.net/tags#Python-ref

Social sharing links are need of every blog. But Share widgets are usually a nuisance, from reading and privacy point of view.

These issues can be covered using textual links. So instead of a twitter button you will have a Share this on twitter link.

See Share Link Generator for examples.

This may require a Pelican plugin. Plugin will generate the links and add it to article attributes article.twitter, article.reddit.

Question is how will Elegant utilize this plugin. It will let user define a message.

SOCIAL_SHARING_MESSAGE = u'If you like this article please share it on FACEBOOK | TWITTER | REDDIT | HACKERNEWS.'

Elegant will replace FACEBOOK with article.facebook. If article.facebook is not defined then Elegant will not do anything.

Elegant can create URL for each social network. But lets do it in a plugin so that other themes can also use it.

@tshepang reported at twitter

See the gradient in "Get Elegant button" or Download button of Font Awesome.

Use foobar

"CRITICAL: 'RECENT_ARTICLES_COUNT' is undefined"

I experimented with using other pelican themes and don't encounter this error message.

Add information about RSS feed and how they appear on every page.

Why there is no visible cue?
B/c people are not using it that much

Set TWITTER_USERNAME
Set TWITTER_CARD to True

Validate and Apply
What is Card
What meta tags Elegant uses?

Tutorial one
Tutorial two

User should be able to disable favicons from project settings. See #9

Here's a screenshot:

1. I have enabled feed but it's icon does not appear
2. How do I add social icon for x website
3. How do I add RSS icon
4. How do I get line numbers in code #14
5. How to disable overwrapping in <pre> block #8
6. How do I use twitter cards
7. Why is links color so muted
8. Stat Counter codes link
9. I don't want to use solarized theme for code
10. What if you don't want to use custom CSS to reduce HTTP requests

The recommended font size for reading on web is around 16pt, which in our case will translate to 1.2 em.

Reported on twitter by @tshepang

See example

For reference

1. Nicholas Carr's Experiments in delinkification
2. @tshepang tweet

pdhbreak started this conversation

And I love the content table on the left. If it can scroll with the page, much more useful.

That was my original plan. During beta testing prior to release of version 1.0, it turned out to be a source of distraction for the readers. So I removed it. But you are right, there should be some sort of visible navigational menu for the user when he scrolls down. I am looking for ideas. Please feel free to share your ideas here.

(source)

This link should reach the oldest Comment in that thread, but it doesn't. This is likely related to the fact that Comments are hidden by default.

If I include font awesome to the theme then it should be exposed to the users (perhaps via documentation) so that they can use it too in their markup.

It is part of article. It should not be different.

It is a matter of continuity. For a reader comments are part of article or at least related to. The navigation section should come at the bottom.

This is what it should look like

article
comments intro
comments
horizontal line
next previous article nav section

At the moment, they are only identified by font, which does not make them distinguishable enough:

1. https://twitter.com/tshepang_dev/status/384347807387095040
2. https://twitter.com/cahuk/status/391533360830775296

There are 3 links in the following image, but it's not so easy to tell:

• Google's HTML/CSS Style Guide
• GitHub Styleguide
• Idiomatic CSS
• CSS Wizardry

Social buttons like twitter should be consistent with other Pelican themes. You may also want to add RSS button.

For RSS button, see conversation with @tshepang at twitter.

See issue #19 for discussion on it.

Now the question is should a patch be submitted to Pelican to have a datetime metadata for last-updated beside date. Otherwise Pelican treats every custom metadata as string.

Just like mailchimp form heading

title - GitHub alone is not enough to keep title separated from site name visually.

1. you can use double dash title — GitHub
2. or use Github style title · GitHub

So user can use site wide Comments_Intro or article.comments_intro. This way he can write custom comments intro for every article.

• Accept patch
• Test it
• Attribute it to Jed Brown
• Add documentation

diff --git i/templates/base.html w/templates/base.html
index a816ae7..d40ee1c 100644
--- i/templates/base.html
+++ w/templates/base.html
@@ -13,6 +13,12 @@
         <meta name="author" content="{{ AUTHOR }}" />
         <meta name="copyright" content="{{ AUTHOR }}" />
         {% endif %}
+        {% if article and article.latex %}
+          {{ article.latex }}
+        {% endif %}
+        {% if page and page.latex %}
+          {{ page.latex }}
+        {% endif %}

         {% if SITE_DESCRIPTION %}
         <meta name="description" content="{% block head_description %}{{ SITE_DESCRIPTION }}{% endblock head_description %}" />

Create a FAQ section and explain it there.

Font is very different from rest of the theme.
Shouldn't be bold.
Button background takes away attention

Make font black and background light.

I saw this in templates/base.html.

See discussion at #10

Here's a screenshot: