{"id":17122225,"url":"https://github.com/ashander/pelican-bootstrap3","last_synced_at":"2025-06-16T03:40:42.593Z","repository":{"id":142804259,"uuid":"69409724","full_name":"ashander/pelican-bootstrap3","owner":"ashander","description":"a mirror of a pelican theme","archived":false,"fork":false,"pushed_at":"2016-09-28T00:26:45.000Z","size":3767,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-29T08:47:38.255Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ashander.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-09-28T00:25:13.000Z","updated_at":"2016-09-28T00:26:29.000Z","dependencies_parsed_at":"2023-05-22T09:45:20.499Z","dependency_job_id":null,"html_url":"https://github.com/ashander/pelican-bootstrap3","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashander%2Fpelican-bootstrap3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashander%2Fpelican-bootstrap3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashander%2Fpelican-bootstrap3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashander%2Fpelican-bootstrap3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ashander","download_url":"https://codeload.github.com/ashander/pelican-bootstrap3/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245200675,"owners_count":20576673,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-14T18:06:49.950Z","updated_at":"2025-03-24T02:46:48.784Z","avatar_url":"https://github.com/ashander.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pelican-bootstrap3\n\nThis is a Bootstrap 3 theme for Pelican. It's fully responsive. Bootstrap 3 has seen an official, final release now, so\nI don't expect any breaking changes anymore. I will try to keep it up-to-date.\n\n## CONTRIBUTING\n\nIf you want to adjust this theme to your own liking, I encourage you to fork it. This theme has started to gather more\nand more attention in the form of stars and forks. If you make improvements that are useful to others and can make the\ntheme better in general **please don't hesitate to make a pull request**. For contributing guidelines, [look here](CONTRIBUTING.md)\n\n## Installation\n\nFirst:\n\n`git clone https://github.com/DandyDev/pelican-bootstrap3.git`\n\nThen:\n\nPoint the `THEME` variable in your `pelicanconf.py` to `/path/to/pelican-bootstrap3`\n\n## Usage\n\nThis theme honors the following standard Pelican settings:\n\n* Putting feeds in the `\u003chead\u003e` section:\n\t* `FEED_ALL_ATOM`\n\t* `FEED_ALL_RSS`\n* Template settings:\n\t* `DISPLAY_PAGES_ON_MENU`\n\t* `DISPLAY_CATEGORIES_ON_MENU`\n\t* `MENUITEMS`\n\t* `LINKS` (Blogroll will be put in the sidebar instead of the head)\n* Analytics \u0026 Comments\n\t* `GOOGLE_ANALYTICS` (classic tracking code)\n\t* `GOOGLE_ANALYTICS_UNIVERSAL` and `GOOGLE_ANALYTICS_UNIVERSAL_PROPERTY` (Universal tracking code)\n\t* `DISQUS_SITENAME`\n\t* `PIWIK_URL`, `PIWIK_SSL_URL` and `PIWIK_SITE_ID`\n\nIt uses the `tag_cloud` variable for displaying tags in the sidebar. You can control the amount of tags shown with: `TAG_CLOUD_MAX_ITEMS`\n\n## Extras\n\n### Bootswatch and other Bootstrap 3 themes\n\nPart of the versatility of this theme comes from the fact that I included all the lovely Bootstrap 3 themes from [Bootswatch](http://bootswatch.com/), built by [Thomas Park](https://github.com/thomaspark). You can tell Pelican what Bootswatch theme to use, by setting `BOOTSTRAP_THEME` to the desired theme, in lowercase (ie. 'readable' or 'cosmo' etc.). My own site is using _Simplex_. If you want to use any other Bootstrap 3 compatible theme, just put the minified CSS in the `static/css` directory and rename it using the following naming scheme: `bootstrap.{theme-name}.min.css`. Then update the `BOOTSTRAP_THEME` variable with the _theme-name_ used.\n\n### Article info\n\nSet `SHOW_ARTICLE_AUTHOR` to True to show the author of the article at the top of the article and in the index of articles. Set `SHOW_ARTICLE_CATEGORY` to show the Category of each article. Set `SHOW_DATE_MODIFIED` to True to show the article modified date next to the published date.\n\n### Custom CSS\n\nIf you want to add custom css to the theme, without having to clone and maintain your own version of the theme, you can use the `CUSTOM_CSS` variable. The value is the location where you tell Pelican to put the file (see below):\n\n```\nCUSTOM_CSS = 'static/custom.css'\n```\n\nTo tell Pelican to copy the relevant file to the desired destination, add the path to `STATIC_PATHS` and the destination to `EXTRA_PATH_METADATA`, like so:\n\n```\n# Tell Pelican to add 'extra/custom.css' to the output dir\nSTATIC_PATHS = ['images', 'extra/custom.css']\n\n# Tell Pelican to change the path to 'static/custom.css' in the output dir\nEXTRA_PATH_METADATA = {\n    'extra/custom.css': {'path': 'static/custom.css'}\n}\n```\n\n### Pygments\n\nYou can choose the syntax highlighting style by using the `PYGMENTS_STYLE` variable to specify one of the built-in Pygments styles. By default the `native` style is used. The following styles are avaiable:\n\n- autumn\n- borland\n- bw\n- colorful\n- default\n- emacs\n- friendly\n- fruity\n- manni\n- monokai\n- murphy\n- native\n- pastie\n- perldoc\n- solarizeddark\n- solarizedlight\n- tango\n- trac\n- vim\n- vs\n- zenburn\n\nFor a demo of the different Pygment styles, have a look [here](http://pygments.org/demo/218030/)\n\n### Pagination\n\nPelican-Bootstrap3 follows the standard Pagination settings of Pelican and uses the Bootstrap3 [Pagination component](http://getbootstrap.com/components/#pagination), but you can optionally use the Boostrap3 _Pager_ by setting `USE_PAGER` to `True`.\n\n### Bootstrap fluid layout\n\nIf you'd like to use the fluid container layout from Bootstrap, set the flag `BOOTSTRAP_FLUID` to _True_.\n\n### Site Brand\n\nYou can provide a logo for your site using `SITELOGO`. For example: `SITELOGO = 'images/my_site_logo.png'`. You can then define the size of the logo using `SITELOGO_SIZE`. The `width` of the `\u003cimg\u003e` element will be set accordingly.\n\nBy default the `SITENAME` will be shown as well. It's also possible to hide the site name using the `HIDE_SITENAME` flag.\n\n### Breadcrumbs\n\nIt's possible to show breadcrumbs in your site using the `DISPLAY_BREADCRUMBS` flag. By default the article category isn't shown in the breadcrumbs, if you wish to enable it, set the `DISPLAY_CATEGORY_IN_BREADCRUMBS` flag to _True_.\n\n### Navbar\n\nIf you wish to use the inverse navbar from Bootstrap, set the flag `BOOTSTRAP_NAVBAR_INVERSE` to _True_.\n\n### Related Posts\n\nThis theme has support for the [Related Posts plugin](https://github.com/getpelican/pelican-plugins/tree/master/related_posts). All you have to do, is enable the plugin, and the theme will do the rest.\n\n### IPython Notebook support\n\nThis theme supports including IPython notebooks through the [Liquid Tags plugin](https://github.com/getpelican/pelican-plugins/tree/master/liquid_tags). If you enable the plugin, the theme will automatically include the right CSS/JS to make the notebooks work.\n\n### Favicon\n\nSet the `FAVICON` option in your `pelicanconf.py`. For example: `FAVICON = 'images/favicon.png'`\n\n### Index page\n\n* If `DISPLAY_ARTICLE_INFO_ON_INDEX` is set to _True_, article info (date, tags) will be show under the title for each article, otherwise only title and summary will be shown (default). \n\n### Short menu labels for pages\n\nBy default, the title of a page is used both for showing the title as\npart of a page's content, and, if pages in menu is enabled, as the\nlabel of the corresponding menu item. You can choose a different label\nfor the menu (such as a short single word) than the page title by adding a\nMenulabel metadata attribute to the page header (`Menulabel:` in\nmarkdown, `:Menulabel:` in rst).\n\n### About Me\n\nYou can show a short blurb of text about yourself and a picture. The following two settings are used for this:\n\n* Your 'About Me' paragraph will be whatever the `ABOUT_ME` variable is set to (raw html is allowed)\n* Your avatar can be set by pointing the `AVATAR` variable to the relevant picture (e.g. 'images/profile.png')\n\n### Banner Image\n\nA banner image can be added to the theme, displayed with the SITENAME and an optional subtitle. Config options are as follows:\n\n* Set the banner image with `BANNER = '/path/to/banner.png'`\n* Set the subtitle text with `BANNER_SUBTITLE = 'This is my subtitle'`\n* By default, the banner is only shown on the index page. To display the banner on all pages, set `BANNER_ALL_PAGES = True`\n\n### Sidebar options\n\nThe following things can be displayed on the sidebar:\n\n* **Social links** can be provided through the `SOCIAL` variable. If it's empty, the section will not be shown\n\t* In your `pelicanconf.py` provide your social links like this:\n\n```\nSOCIAL = (('twitter', 'http://twitter.com/DaanDebie'),\n          ('linkedin', 'http://www.linkedin.com/in/danieldebie'),\n          ('github', 'http://github.com/DandyDev'),)\n```\n* **Tags** will be shown if `DISPLAY_TAGS_ON_SIDEBAR` is set to _True_. Normally, tags are shown as a list.\n\t* Set `DISPLAY_TAGS_INLINE` to _True_, to display the tags inline (ie. as tagcloud)\n* **Categories** will be shown if `DISPLAY_CATEGORIES_ON_SIDEBAR` is set to _True_\n* **Recent Posts** will be shown if `DISPLAY_RECENT_POSTS_ON_SIDEBAR` is set to _True_\n\t* Use `RECENT_POST_COUNT` to control the amount of recent posts. Defaults to **5**\n\nTo remove the sidebar entirely, set `HIDE_SIDEBAR` to _True_.\n\n### reStructuredText styles\n\nIf you're using reStructuredText for writing articles and pages, you can include the extra CSS styles that are used by the `docutils`-generated HTML by setting `DOCUTIL_CSS` to True. This can be done as a global setting or  setting it in the metadata of a specific article or page.\n\n### Disqus comments\n\n* This theme sets identifiers for each article's comment threads. If you are switching from a theme that doesn't (such as the Pelican built-in default) this will result in existing comments getting lost. To prevent this, set DISQUS_NO_ID to _True_.\n* Set DISQUS_ID_PREFIX_SLUG to _True_ if you have configured your article URLs such that the slug alone will likely not be unique. Ignored if DISQUS_NO_ID is _True_.\n* 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-'.\n* To show Disqus comment counts on the index page, set DISQUS_DISPLAY_COUNTS to _True_.\n\n### Content license\n\nYou can optionally declare a [Creative Commons license](http://creativecommons.org) for the content of your site. It will appear in the site's footer. To enable, use one of the following two ways for configuration.\n\n* To choose the license by name, set `CC_LICENSE` to the common abbreviated name of the license: `\"CC-BY\"` (require attribution), `\"CC-BY-SA\"` (require ShareAlike), `\"CC-BY-ND\"` (NoDerivatives) , `\"CC-BY-NC\"` (require attribution, no commercial reuse), `\"CC-BY-NC-SA\"` (require ShareAlike, no commercial reuse), or `\"CC-BY-NC-ND\"` (NoDerivatives, no commercial reuse).\n* Alternatively, choose the licence by features:\n    * `CC_LICENSE_DERIVATIVES` - `\"yes\"` if permitted, `\"no\"` if not permitted, and `\"ShareAlike\"` if derivatives must be shared under the same terms.\n    * `CC_LICENSE_COMMERCIAL` - `\"yes\"` if commercial reuse is permitted, and `\"no\"` otherwise. \n* Optionally, you can include attribution markup in the license mark by setting `CC_ATTR_MARKUP` to _True_.\n\nThe license choice mirrors the [Creative Commons License Chooser](http://creativecommons.org/choose/). Source for the macro that renders the mark is at http://github.com/hlapp/cc-tools.\n\n### GitHub\n\nThe theme can show your most recently active GitHub repos in the sidebar. To enable, provide a `GITHUB_USER`. Appearance and behaviour can be controlled using the following variables:\n\n* `GITHUB_REPO_COUNT`\n* `GITHUB_SKIP_FORK`\n* `GITHUB_SHOW_USER_LINK`\n\n### Facebook Open Graph\n\nIn order to make the Facebook like button and other social sharing options work better, the template contains Open Graph metatags like `\u003cmeta property=\"og:type\" content=\"article\"/\u003e`. You can disable them by setting `USE_OPEN_GRAPH` to _False_. You can use `OPEN_GRAPH_FB_APP_ID` to provide a Facebook _app id_. \nYou can also provide a default image that will be passed as an Open Graph tag  by setting `OPEN_GRAPH_IMAGE` to a relative file path, which will be prefixed by your site's base url. Optionally, you can override this default image on a per article and per page basis, by setting the `og_image` variable in an article or page.\n\n### Twitter Cards\n\nThe theme supports [Summary Twitter Cards](https://dev.twitter.com/docs/cards/types/summary-card). To activate the necessary tags set `TWITTER_CARDS` to `True`. Because _Twitter Cards_ also use Open Graph tags to identify some of the necessary metadata, `USE_OPEN_GRAPH` must also be set to `True` (which is the default).\n\nYou can optionally provide a `TWITTER_USERNAME` which will be used to set the Twitter username for the site and for the content creator.\n\nThe same image options for Open Graph (see above) can be used for setting images that appear on Twitter Cards. So if you have set an `OPEN_GRAPH_IMAGE` and optionally `og_image` for articles and/or pages, you're good to go for Twitter Cards as well.\n\n### Twitter Timeline\n\nThe theme can show your twitter timeline in the sidebar. To enable, provide a `TWITTER_USERNAME` and a `TWITTER_WIDGET_ID`.\n\nTo get a `TWITTER_WIDGET_ID`, go to: https://twitter.com/settings/widgets and select `Create new`. You'll find the TWITTER_WIDGET_ID under the html or in the site url:\n\n`https://twitter.com/settings/widgets/TWITTER_WIDGET_ID/edit`\n\n### AddThis\n\nYou can enable sharing buttons through [AddThis](http://www.addthis.com/) by setting `ADDTHIS_PROFILE` to your AddThis profile-id. This will display a **Tweet**, **Facebook Like** and **Google +1** button under each post.\n\n* AddThis automatically adds a short hashtag to the end of your URLs. This lets you reveal how often visitors copy your URL from their address bar to share. Example of URL: `http://domain.com/page.html#UF0983`. This function can be disabled by setting `ADDTHIS_DATA_TRACK_ADDRESSBAR` to _False_.\n* All social buttons are enabled by default. You can disable certain button by setting following properties to _False_: `ADDTHIS_FACEBOOK_LIKE`, `ADDTHIS_TWEET`, `ADDTHIS_GOOGLE_PLUSONE`.\n\n### Tipue Search\n\nThis theme has support for the\n[Tipue Search plugin](https://github.com/getpelican/pelican-plugins/tree/master/tipue_search).\n\nAll you have to do, is:\n- enable the plugin, and the theme will add a search box on the right\n  side of the menu\n- Add `DIRECT_TEMPLATES = (('search',))` in your `pelicanconf.py`.\n\n\n### Footer\n\nThe footer will display a copyright message using the AUTHOR variable and the year of the latest post. If a content license mark is enabled (see above), that will be shown as well. \n\n## Live example\n\n[This is my website](http://dandydev.net)\n\nIf you want more examples of what you could do with this theme, have a [look here](EXAMPLES.md).\n\n## Screenshot\n\n![](screenshot.png)\n\n![](screenshot-article.png)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashander%2Fpelican-bootstrap3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fashander%2Fpelican-bootstrap3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashander%2Fpelican-bootstrap3/lists"}