Giter VIP home page Giter VIP logo

flex's Introduction

Flex

The minimalist Pelican theme.

Flex 3.0 and upcoming breaking changes

Flex 2.6 will be the last release without breaking changes.

Flex 3.0 is under development and will introduce breaking changes.

The breaking changes will include:

  • Removal of deprecated plugins and integrations
  • Removal and renaming of configuration variables
  • Removal of Less.js and Gulp.js
  • Refactoring of multiple templates

Flex has grown beyond expectation over the last few years and is hard to maintain and accept new features.

You can check the current progress in the v3 branch.

New features won't be accepted unless submited to v3 branch, bug fixes will still be accepted in the master branch.

Once 2.6 is out, the v3 branch will be merged into master.

Features

Integrations

Plugins Support

Install

The best way to install is over pelican-themes.

The alternative way is to clone this repository and checkout a tag branch.

Documentation

The documentation covers most of the settings available and how to use this theme. If something is missing or broken you can open a PR or fix the documentation by yourself.

Flex Wiki

Live example

You can see how this theme looks like at http://flex.alxd.me/.

The code is available in this project under docs folder.

Contributing

ALWAYS open an issue before sending a PR. Discuss the problem/feature that you want to solve. If things make sense, send a PR with your changes.

As always, if you want something that only makes sense to you, fork Flex and create a new theme.

Translations

Translate this theme to new languages at Transifex.

Read more about Translation Support in the Wiki.

License

MIT

flex's People

Contributors

alexandrevicenzi avatar barryorourke avatar cassiobotaro avatar echoalexey avatar elementalvoid avatar fghaas avatar haplo avatar jac18281828 avatar linkid avatar lioman avatar lpenaud avatar maparent avatar marcelhuth avatar markcaudill avatar ncharlot avatar nicopy avatar noirbizarre avatar okelet avatar olipratt avatar pawelngei avatar phyks avatar radoeka avatar rhyven avatar ricekab avatar saagit avatar sashw avatar schmittlauch avatar schtobia avatar sumnerevans avatar xion avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

flex's Issues

Strange display of URL for articles

Here is what I have in pelicanconf.py :

ARTICLE_URL = '{date:%Y}/{date:%b}/{date:%d}/{slug}/'
ARTICLE_SAVE_AS = '{date:%Y}/{date:%b}/{date:%d}/{slug}/index.html'

The issue is that articles then render as:

2016/Dec/15/some-article-link/#some-article-link

The pelican docs use this example and show a different rendering of the URL. Is this an issue with the theme?

The rendering I'd like, as my old blog had, is:

2016/Dec/15/some-article-link/

Add 'neighbors' plugin support

Hi,

I've been looking at adding support for the neighbors plugin to Flex, so I can get previous/next post buttons on articles.

If you're happy to accept that (and it won't change anything if you don't enable the plugin) I'll probably submit a PR around the weekend, but the interesting thing is that I think it will add new text - 'Previous Post' and 'Next Post', which I think would need translating - so not sure what the impact of that is or if it's a problem?

Thanks.

Thank you!

I don't actually have an issue πŸ˜„

Just wanted to say thanks for this theme and its liberal license. As someone who can't design his way out of a beartrap, I've spent a long time finding a theme I like for my latest project (click if you're interested). This theme is pretty much perfect for what I need and it looks awesome. I may even use it in other projects.

Markdown paragraph symbol visible in preview page

I'm not sure if this an issue on my end as I am new to pelican in general, but when on the home page the markdown paragraph symbol is visible at all times (should only be visible on hover over). This Markdown text comes from a Jupyter notebook using the ipynb plugin.

image

However when I am viewing the post the Markdown paragraph symbol is invisible as expected (visible only on hover over functionality is still present, again as expected).

image

Thoughts?

Help with About Sections

Hi Alexandre,
Great template, thank you for sharing!

I am having two issues with the about and contact sections I am trying to place.

1- Whenever I try to click on home or the image I get directed to http://dazajuandaniel.github.io/dazajuandaiel.github.io instead of http://dazajuandaniel.github.io

2- The about or contact section directs me to https://dazajuandaniel.github.io/dazajuandaniel.github.io/pages/about.html#about and the HTML file is corrupted.

Link to my repository:
link

I have two branches the "Master" and "Source". The "Source" contains all the pelican files. I am using Windows machine with the Git Bash.

Image Post

Usually, posts have a main image. I know it's not a standard in pelican. Although, I thought It would be nice to be able to have a image for each post as a attribute in the header of the post.

Pagination button don't display with the same height

Hi,

First off - thanks for making this great theme and sharing it!

Small issue - I noticed that the pagination buttons don't quite display in a matching way in my browser - their heights aren't equal which looks wrong because they are vertically aligned. Here's a screenshot from index2.html in the tests:
before_fix
That's on Windows 10 / Chrome 56.0.2924.87.

I've looked at the code and propose a fix where the float: left style is applied to the Older Posts button - I'll submit a pull request. That seems to make them display evenly for me, but I've basically never written any CSS so I'm not sure it's the 'right' fix.

Thanks again.

Posts preview on main page.

There is a cool option with preview of posts when they grouped by tag.

1
Is there any way to do the same on main page?
2

Thanks in advance!

X minute read like Medium

post_stats offers some stats, it could be used to add X minutes read like Medium.

Here's an example:

{% if post_stats_enabled %}
{{ article.stats['read_mins'] }} minute read
{% endif %}

HOME button dose not work

The HOME button on the top MENUITEMS not work and HTML element shows:

<a href="">    Home
</a>

If i add a MENUITEM use link "/", and the element shows:

<a href="/">    Home
</a>

and it works just like a real HOME button. how can i fix the defult HOME button?
Thanks.

Search

There's a plugin tipue_search to enable some kind of search.

It also could be used Google custom search or anything else.

Some ideas

  • In the archives, each pair of post date/title seem to need a little more separation between each other.
  • Don't show the header photo when the screen is small to avoid scrolling?

Justify text in the articles

Hi,

Is it possible to justify text in articles?
I added the following custom CSS:

article p {
  text-align: justify;
}

But is there any drawback to do so, and if not maybe include it by default?

Social icons problem

Hi Alexandre,

I really appreciate your work, it looks perfect on my blog except there were no social icons show up. Finally I noticed the path is not correct.

On file 'base.html' line 14, the href shoud be
"{{ SITEURL }}/{{ THEME_STATIC_DIR }}/font-awesome/css/font-awesome.min.css"
instead of
"{{ SITEURL }}/{{ THEME_STATIC_DIR }}/font-awesome/font-awesome.min.css".

Hope this would help.

Best,
Fan Yang

Display authors in posts and front page

Thanks for an awesome theme, Alex. Small issue - there doesn't appear to be any setting to specify the authors of posts in the main feed, or even in the posts themselves. Is this deliberate?

Theme translations

Pelican supports translation. Flex is only in English, if someone want to use in pt-BR it need to edit the theme.

It's good to not break things if use i18n.

Jinja way to translate

Google AdSense support

Well, it's very common and useful. But the question is: Where must the banners be placed?

It's not good to add 10 banners per page. One is annoying, so it must be something careful, or not done at all.

Just thinking about this today.

Codeblock displays the whole code on one line

Hi, I've been using your theme for my blog and I really love it, amazing work.

However I have an issue that I can't manage to fix.

When I write a codeblock in my markdown files :

[Packager]  
Name=Votre Nom  
Email=votre.adresse@email

It is displayed only on one line no matter what I do. So it's not really readable.
An example can be found here

Do you have an idea ?

PS: I tried several versions of the theme and it's always the same thing...

Spanish translation

It would be great to have spanish (from Spain). If you want, I could help you with it (I'm spanish).

Unable to get fr translations

Hi!

We're launching a blog in french only.
After many tries, can't get translations. Still "Posted on..." rather than "PostΓ© le ...".

This is the conf:

# Default theme language.
I18N_TEMPLATES_LANG = 'fr'
DEFAULT_LANG = 'fr'
LOCALE = 'fr_FR'
OG_LOCALE = 'fr_FR'

JINJA_ENVIRONMENT = {'extensions': ['jinja2.ext.i18n']}

PLUGIN_PATHS = ['pelican-plugins']
PLUGINS = ['i18n_subsites']

Do we really need i18n_subsites module?

Thanks for your help.

markdown-css

Hi,I have been using your theme for blog,too.I prefer writing with markdown.
And how can I replace default markdown-css with github-markdown-css.

Do guys have a idea?

Add Tests

Add Travis CI tests.

Just a way to compile using all settings to try to catch some error if any.

Bug in CSS with placement of "Newer Posts" button

Hi,
it seems that there is a bug in CSS with placement of "Newer Posts" button on index.html pages. The issue only applies when there is only one article on the page.

bildschirmfoto 2015-12-22 um 12 15 16

Unfortunately I'm not the CSS expert to figure out the error on my own :(

I did change a couple of things in my fork of the repo, but AFAIK non of the changes should have changed that property. Probably you can recreate the issue? I'll try to fix that during the next days.

Thanks for your help in advance!

Cheers,
Marcel

Question about changing css

Hi

Could you help me out. I'm trying to edit your theme a bit - for example removing the lowercase text-transform for the sidebar items. I've removed it from the less and css files, then reinstalled the theme, but it doesn't seem to stop it happening.

How should I edit the css if not via the less or the minified css. I'm a newb on less and css and hwo they might work together.

Thanks

Improve tests

There are a lot of new features and they need some kind of test.

gettext is undefined

I am trying the new theme, with translations, but I can not get it to work; I get this error:

CRITICAL: UndefinedError: 'gettext' is undefined
Traceback (most recent call last):
  File "/usr/bin/pelican", line 9, in <module>
    load_entry_point('pelican==3.6.3', 'console_scripts', 'pelican')()
  File "/usr/lib/python2.7/dist-packages/pelican/__init__.py", line 478, in main
    pelican.run()
  File "/usr/lib/python2.7/dist-packages/pelican/__init__.py", line 183, in run
    p.generate_output(writer)
  File "/usr/lib/python2.7/dist-packages/pelican/generators.py", line 587, in generate_output
    self.generate_pages(writer)
  File "/usr/lib/python2.7/dist-packages/pelican/generators.py", line 486, in generate_pages
    self.generate_articles(write)
  File "/usr/lib/python2.7/dist-packages/pelican/generators.py", line 364, in generate_articles
    blog=True)
  File "/usr/lib/python2.7/dist-packages/pelican/writers.py", line 211, in write_file
    override_output)
  File "/usr/lib/python2.7/dist-packages/pelican/writers.py", line 155, in _write_file
    output = template.render(localcontext)
  File "/usr/lib/python2.7/dist-packages/jinja2/environment.py", line 989, in render
    return self.environment.handle_exception(exc_info, True)
  File "/usr/lib/python2.7/dist-packages/jinja2/environment.py", line 754, in handle_exception
    reraise(exc_type, exc_value, tb)
  File "/home/jasensios/Dropbox/pelican-blog/themes/flex/templates/article.html", line 1, in top-level template code
    {% extends "base.html" %}
  File "/home/jasensios/Dropbox/pelican-blog/themes/flex/templates/base.html", line 138, in top-level template code
    <a href="{{ SITEURL }}">{{ _('Home') }}</a>
  File "/usr/lib/python2.7/dist-packages/jinja2/ext.py", line 132, in _gettext_alias
    return __context.call(__context.resolve('gettext'), *args, **kwargs)
jinja2.exceptions.UndefinedError: 'gettext' is undefined

This is the relevant configuration:

PLUGIN_PATHS = ["plugins", "custom-plugins"]
PLUGINS = ['i18n_subsites', 'summary', 'sitemap', 'feed_summary']
JINJA_EXTENSIONS = ['jinja2.ext.i18n']

DEFAULT_LANG = 'es'
OG_LOCALE = 'es_ES'
LOCALE = 'es_ES'
I18N_TEMPLATES_LANG = 'en'

Also I have generated a custom translation with the commands in the wiki:

./translation.sh new es_ES
# edited with poedit
./translate.sh compile

GitLab Social Icon

Hello,

I'm currently starting my own blog using Pelican and your awesome theme πŸ‘ πŸŽ‰ .

I've been playing with social icons so far, and I have realized that there is no support for GitLab icon, as there is for GitHub.

I think it would be easy to include an orange background with the FontAwesome GitLab Icon, like the following image:

gitlab-icon-preview

CSS code

ul.social a.sc-gitlab {
    background-color: orange
}

I'm not a web developer, so any help or comments are welcome. Would you like this change in a PR?

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.