Flexible-Jekyll is a simple and clean theme for Jekyll

  • By Artem Sheludko
  • Last update: Jan 2, 2023
  • Comments: 15


  • 1

    Photo Credits

    I don't know if the feature exists or not... I'm using photos from Flickr with "All creative commons" license in my posts and I would like to include the author of the picture or in some way give credit to the person who shot the photograph. Could be a note just below the image or on top of the image on one of the bottom corners. If you can point me in the right direction I'll appreciated.

  • 2

    Some text format in markdown cannot dispaly in the webpage

    Hello, I really love your theme and thanks for sharing with us. Today I encunted a problem. Hope you can help me.

    Some text format in markdown cannot display in the webpage (showed in the picture) while it can do in the GitHub.


    • GitHub https://github.com/Marina-Ma/Marina-Ma.github.io/blob/master/_posts/2017-10-26-Markdown-Writing.md

    • webpage https://marina-ma.github.io/Markdown-Writing/



  • 3

    Providing no image leaves an empty space


    nice effort 👍

    Maybe I haven't taken enough time to read the project, but the image of a post is meant to be an optional attribute. However, if I don't provide any image, I end up with a post that looks like corrupted to the user:

    screen shot 2017-10-14 at 02 10 58

    Am I missing something or is it indeed a bug?

    Regards, Thodoris

  • 4

    Code highlighting scroll?

    Is there a way to make the code scroll instead of wrap? If I remove these tags from the pre and pre code sections of the css:

    overflow: auto;
    white-space: pre-wrap;
    word-wrap: break-word;
    word-break: break-all;

    and replace them with

    overflow-x: auto

    then the code highlight overflows beyond the padding of the wrap-content div class. I can add a max-width tag just below overflow-x: auto to limit this, but a value for max-width that looks good is different for different screen sizes, creating a huge hassle. Is there a way to make the code scroll and prevent it from overflowing?

  • 5

    Great theme - needs a little correction.

    The theme looks great @artemsheludko . But it makes an api call! I tried to see why and this is what I found in view source

    <li class="github"><a href="http://github.com/{
      | "api_url": "https://api.github.com",
      | "baseurl": "/flexible-jekyll",
      | "build_revision": "52f93ec6c5f6233eb77fc6770d396ba164a42b51",
      | "clone_url": "https://github.com/artemsheludko/flexible-jekyll.git",
      | "contributors": [
      | {
      | "login": "artemsheludko",
      | "id": 22279513,
      | "avatar_url": "https://avatars3.githubusercontent.com/u/22279513?v=4",
      | "gravatar_id": "",
      | "url": "https://api.github.com/users/artemsheludko",
      | "html_url": "https://github.com/artemsheludko",
      | "followers_url": "https://api.github.com/users/artemsheludko/followers",
      | "following_url": "https://api.github.com/users/artemsheludko/following{/other_user}",
      | "gists_url": "https://api.github.com/users/artemsheludko/gists{/gist_id}",
      | "starred_url": "https://api.github.com/users/artemsheludko/starred{/owner}{/repo}",
      | "subscriptions_url": "https://api.github.com/users/artemsheludko/subscriptions",
      | "organizations_url": "https://api.github.com/users/artemsheludko/orgs",
      | "repos_url": "https://api.github.com/users/artemsheludko/repos",
      | "events_url": "https://api.github.com/users/artemsheludko/events{/privacy}",
      | "received_events_url": "https://api.github.com/users/artemsheludko/received_events",
      | "type": "User",
      | "site_admin": false,
      | "contributions": 4
      | }

    There are a lot more lines. It can be a serious performance issue.

  • 6

    Show pagination only if there is more than one page

    If the blog is still empty the site shows a p tag with content "Page of". If the blog contains only one page the p tag shows "Page 1 of 1". With this PR the pagination-information is only shown if there are at least two pages.

  • 7

    Two files not found

    Two files seem to be missing from the repository which result in the following errors after starting the server:

    `/flexible-jekyll/assets/img/favicon/apple-touch-icon-114x114.png' not found.

    `/flexible-jekyll/assets/img/favicon/favicon.ico' not found.

  • 8

    Fork the "master" branch and delete "gh-pages" branch in it.

    Fork the "master" branch and delete "gh-pages" branch in it. I'm the first time to try it, I can not find "gh-pages",where is it?how to delete it? thanks for reading.

  • 9

    markdown doesn't work on _config.yml


    I know, this is not meant to be the proper way of using jekyll, but please let me explain the following scenario: As an author, I would like to have a link displayed in my author's description (about-author property in _config.yml; example: [Thodoris](link/to/site) ).

    Of course, this is out of the scope of this project, since it is more global, but I would like to first hear your opinion (, since I'm just a newbie with jekyll), before escalating this to the official project (also because I'm not sure whether the main project -jekyll/jekyll- is the most relevant one to this case).

    Regards, Thodoris

  • 10

    Thumbnail's text is displaying author's description


    wouldn't it be nice if thumbnail's text displayed the respective post's first few lines of text (, instead of author's description) ?

    screen shot 2017-10-15 at 02 31 27

    If you want, I can pick this up, if you provide a hint/tip. Regards, Thodoris

  • 11


    Hi @artemsheludko,

    I loved your theme but I missed one detail: pagination.

    In this PR, I've added pagination support.

    This is how the theme looks with this new feature: 2017-10-02_20h39_31

    I hope you like it! Marta

  • 12

    Optimal size of post picture

    I am having trouble to come with pictures that fit perfectly the thumbnail and the top of every post. They seem to never fit both. Is there any ideal dimension?

  • 13

    Gulpgile.js not working in Gulp V4. Gulp V3 to V4 update

    The gulpfile.js uses gulp v3 syntax. It should be updated to v4 syntax.

    Basically, there are two changes needed as far as I can see:

    • need to change the lists to gulp.series in gulp.task...
    • need to reorder the tasks to avoid undefined error

    Please see this stackoverflow post for details.

    The code below was the solution I implemented for my GitHub pages, it seems to work. However, I am not very experienced in gulp so I am not sure if it is the correct fix.

    If anyone can see if I am on the right path I will gladly submit a PR.

    var gulp = require('gulp');
    var sass = require('gulp-sass');
    var prefix = require('gulp-autoprefixer');
    var imagemin = require('gulp-imagemin');
    var pngquant = require('imagemin-pngquant');
    var cache = require('gulp-cache');
    var cp = require('child_process');
    var browserSync = require('browser-sync');
    var jekyll   = process.platform === 'win32' ? 'jekyll.bat' : 'jekyll';
    // Build the Jekyll Site
    gulp.task('jekyll-build', function (done) {
        return cp.spawn( jekyll , ['build'], {stdio: 'inherit'})
            .on('close', done);
    // Rebuild Jekyll and page reload
    gulp.task('jekyll-rebuild', function () {
    // Compile files
    gulp.task('sass', function () {
        return gulp.src('assets/css/scss/main.scss')
                outputStyle: 'expanded',
                onError: browserSync.notify
            .pipe(prefix(['last 15 versions', '> 1%', 'ie 8', 'ie 7'], { cascade: true }))
    // Compression images
    gulp.task('img', function() {
    	return gulp.src('assets/img/**/*')
    			interlaced: true,
    			progressive: true,
    			svgoPlugins: [{removeViewBox: false}],
    			use: [pngquant()]
    // Wait for jekyll-build, then launch the Server
    gulp.task('browser-sync', gulp.series('sass', 'img', 'jekyll-build'), function() {
            server: {
                baseDir: '_site'
            notify: false
    // Watch scss, html, img files
    gulp.task('watch', function () {
        gulp.watch('assets/css/scss/**/*.scss', gulp.series('sass'));
        gulp.watch('assets/js/**/*.js', gulp.series('jekyll-rebuild'));
        gulp.watch('assets/img/**/*', gulp.series('img'));
        gulp.watch(['*.html', '_layouts/*.html', '_includes/*.html', '_pages/*.html', '_posts/*'], gulp.series('jekyll-rebuild'));
    //  Default task
    gulp.task('default', gulp.series('browser-sync', 'watch'));
  • 14

    Unable to embed html file in the post

    Hi there,

    Thanks for sharing your great work. I have a question in how to embed the HTML file in the post markdown file?

    I upload the HTML file to _include folder, and use {% include newyork_map.html %} in the post markdown file.

    But it does not show up in my post, just display the plain text '' .

    Any way to solve it? Thanks!

  • 15

    Description of the post doesn't appear in the main page

    This is a great theme. I have used it for my blog. Thank you.

    In the main page of the web-page, inside the box for a post, I wish to have a brief description of the post to appear along with the title of the post. Presently, the main content is getting displayed, instead of the description that is given in the markdown file of the post. Please let me know if this can be resolved.

    Markdown file of the post: description

    Web-page showing the beginning of the main content instead of description: main page