This theme is based from Material Design Lite templates. It gets the idea from the blog example. This theme is for Nikola static site generator and used Mako templates. The RSS feed icon is getting from Community Icons
To install:
Enter the command line below at the console
$ nikola theme -i mdl
Edit conf.py for setting these values below:
THEME = "mdl"Refer to
Customizing Your Site
for more information. If post_type is used, it accepts a dictionary value,
where key is the post meta type and value is the icon name from
Google Material Design Icons. There is
an example in Customization section.
You can skip this section if the theme is going to be used as it is. As the
final styles.css is generated and placed in assets/css folder.
The css file is generated using SASS compiler. If you
have it installed, you can generate the final styles.css file by calling
make as there is a Makefile that contains the generation commands.
If you want to add custom styles in custom.scss or custom.css, set mdl__custom_css to True. Both files are git-ignored.
If you want to add custom JavaScript in custom.js, set mdl__custom_js to True. The custom.js file is git-ignored.
Here are the components that used in this theme
It supports some variables in the config file (conf.py). Below are the default
values except post_type, where is {}:
GLOBAL_CONTEXT = {
"mdl__version": "1.3.0",
"mdl__color_scheme": "indigo-pink",
"mdl__roboto_font": False,
"mdl__late_load_css": False,
"mdl__cachebusting": "1",
"mdl__fixed_header": False,
"mdl__fixed_drawer": False,
"mdl__no_drawer_button": False,
"mdl__no_desktop_drawer_button": False,
"mdl__multiple_header": False,
"mdl__header_scroll": False,
"mdl__header_waterfall": False,
"mdl__header_waterfall_hide_top": False,
"mdl__header_transparent": False,
"mdl__header_seamed": False,
"mdl__footer": "",
"mdl__navigation_large_screen_only": False,
"mdl__drawer_small_screen_only": False,
"mdl__custom_css": False,
"mdl__custom_js": False,
"drawer_title": "",
"drawer_logo_url": "",
"drawer_show_title": "",
"drawer_description": "",
"drawer_note": "",
"title_row_middle": False,
"navigation_row_middle": False,
"breadcrumb_separator": ">",
"post_type": {
"text": "format_align_justify",
},
"top_nav_header": False,
"more_button_header": [
("/mobile/", "Mobile Site", "Mobile"),
],
"image_plugin": "colorbox",
}
mdl__version is Material Design Lite version numbermdl__color_scheme is
colour scheme from
Material Design Litemdl__roboto_font is a flag whether Roboto font is used, refer to
styles documentationmdl__late_load_css is a flag whether CSS styles are deferred, refer to
Optimize CSS Deliverymdl__cachebusting is a flag solving the cache problem for CSS and JavaScript files.Additional optional MDL classes for outer div element:
mdl__fixed_header is True, class mdl-layout--fixed-header
is applied for making the header always visible, even in small screensmdl__fixed_drawer is True, class mdl-layout--fixed-drawer
is applied for making the drawer always visible and open in larger screensmdl__no_drawer_button is True, class
mdl-layout--no-drawer-button is applied for not displaying a drawer
buttonmdl__no_desktop_drawer_button is True, class
mdl-layout--no-desktop-drawer-button is applied for not displaying a
drawer button in desktop modemdl__multiple_header is True, logo and title will be first line
and top navigation will move to second linetitle_row_middle is True, title row (or first line in multiple
header lines) will position in the middleAdditional optional MDL classes for header element:
mdl__header_scroll is True, class mdl-layout__header--scroll
is applied for making the header scroll with the content and mutually
exclusive with mdl__fixed_headermdl__header_waterfall is True, class
mdl-layout__header--waterfall is applied for allowing a "waterfall"
effect with multiple header linesmdl__header_waterfall_hide_top is True, class
mdl-layout__header--waterfall-hide-top is applied for hiding the top
rather than the bottom rows on a waterfall headermdl__header_transparent is True, class
mdl-layout__header--transparent is applied for making header transparent
(draws on top of layout background)mdl__header_seamed is True, class mdl-layout__header--seamed
is applied for using a header without a shadowmdl__footer is empty. But it could be also either
mdl-mega-footer or mdl-mini-footer or even any custom classes, refer
to [footer documentation]
(http://www.getmdl.io/components/index.html#layout-section/footer)mdl__navigation_large_screen_only is True, it hides navigation
row in multiple header lines on smaller screensnavigation_row_middle is True, navigation row (second line) in
multiple header lines will position in the middlemdl__drawer_small_screen_only is True, it hides drawer on larger
screensdrawer_title is the title in the drawer and it could be set the same as
BLOG_TITLEdrawer_logo_url is the logo url in the drawer and final output is
drawer_show_title is False. It hides the drawer title
(for example, if drawer logo already contains the text).drawer_description is more HTML text between drawer_title and drawer
navigationdrawer_note is more HTML text after drawer navigationpost_type can used to style
different type of posts.top_nav_header is true, navigation will visible when top header is
appeared on wider screen.more_button_header is true, more button at top menu header will visible
after search button. It is a tuple list, where
("URL", "title", "menu name") as format.image_plugin is either empty string, lightbox or
colorbox. It it is empty string, no image plugin will be used. If it is
colorbox, colorbox script is used
to view full images. It is the same image library as
Nikola used. If it is lightbox,
lightbox script is used to view
full images in gallery pages.mdl_version is replaced with mdl__versioncolor_scheme is replaced with mdl__color_schemeroboto_font is replaced with mdl__roboto_fontmega_footer (boolean type) is replaced with mdl__footer (string type)theme-blog is replaced with sitetheme-blog__posts is replaced with site-poststheme-blog__post is replaced with site-posttheme-blog__gallery is replaced with site-gallerytheme-blog__page is replaced with site-pagetheme-blog__listing is replaced with site-listingtheme-card is replaced with site-cardtheme-nav is replaced with site-navigationtheme-nav__button is replaced with site-navigation__buttonprevious is replaced with site-navigation__previousnext is replaced with site-navigation__nexttheme-crumbs is replaced with site-breadcrumbssearchform is replaced with site-header__searchsite-headersite-header__title-rowsite-header__navigation-rowsite-header__row-middlesite-header__navigationsite-header__more-buttonsite-titlesite-drawersite-drawer__titlesite-drawer__descriptionsite-drawer__navigationsite-drawer__notemetadatasite-post__authorsite-post__datesite-post__total-commentsite-post__tagsite-post__source-linksite-post__source-linksite-page-listsite-page-list-postsite-page-storysite-page-tagssite-page-tagsite-footerslideshow is not workingTHEME_COLOR is not used regardless the valueMaterial Design Lite Apache License Version 2.0
Google Material Design Icons - Attribution 4.0 International
RSS Feed Icons - SIL Open Font License 1.1
jQuery - MIT License
Colorbox - MIT License
Lightbox - MIT License
Templates - Apache License Version 2.0