外観の変更

基本的な外観の設定は、themes/learn/layouts/partials/内のファイルで定義されています

$ tree themes/learn/layouts/partials
themes/learn/layouts/partials
├── custom-comments.html
├── custom-footer.html
├── custom-header.html
├── favicon.html
├── footer.html
├── header.html
├── logo.html
├── menu-footer.html
├── menu.html
├── meta.html
├── search.html
├── tags.html
└── toc.html

変更（カスタマイズ）したい場合は、これらのファイルをトップディレクトリの/layouts/partials/内にコピーして編集を行います

ロゴの変更

/themes/learn/layouts/partials/logo.htmlを/layouts/partianls/logo.htmlとしてコピー

cp themes/learn/layouts/partials/logo.html layouts/partials/.

logo.htmlを編集

svgで囲まれたタグを削除し、HTMLにてimgタグを記述します。
画像は、/static/に配置します(/static/内にimgやimagesなどのフォルダを作成しておくと良いでしょう) ロゴの画像サイズは自動でリサイズされます

faviconの変更

変更したいpngファイルを/static/images/favicon.pngの名前で配置します
/themes/learn/layouts/partials/favicon.htmlを/layouts/partianls/favicon.htmlとしてコピー

favicon.htmlを編集

<link rel="shortcut icon" href="/images/favicon.png" type="image/x-icon" />

配色の変更

learnテーマでは、デフォルトで配色が紫色になってますが、赤・青・緑色の配色へ変更する定義が導入されています

$ ls themes/learn/static/css/theme-*
themes/learn/static/css/theme-blue.css
themes/learn/static/css/theme-green.css
themes/learn/static/css/theme-red.css

config.tomlに下記を記述するだけで簡単に変更が可能

[params]
  # Change default color scheme with a variant one. Can be "red", "blue", "green".
  themeVariant = "blue"

配色を自分で設定

赤・青・緑以外の配色を自分用に設定したい場合は、/static/css/theme-mine.cssの様なファイルを作成し、下記の用に記述します


:root{
    
    --MAIN-TEXT-color:#323232; /* Color of text by default */
    --MAIN-TITLES-TEXT-color: #5e5e5e; /* Color of titles h2-h3-h4-h5 */
    --MAIN-LINK-color:#1C90F3; /* Color of links */
    --MAIN-LINK-HOVER-color:#167ad0; /* Color of hovered links */
    --MAIN-ANCHOR-color: #1C90F3; /* color of anchors on titles */

    --MENU-HEADER-BG-color:#1C90F3; /* Background color of menu header */
    --MENU-HEADER-BORDER-color:#33a1ff; /*Color of menu header border */ 

    --MENU-SEARCH-BG-color:#167ad0; /* Search field background color (by default borders + icons) */
    --MENU-SEARCH-BOX-color: #33a1ff; /* Override search field border color */
    --MENU-SEARCH-BOX-ICONS-color: #a1d2fd; /* Override search field icons color */

    --MENU-SECTIONS-ACTIVE-BG-color:#20272b; /* Background color of the active section and its childs */
    --MENU-SECTIONS-BG-color:#252c31; /* Background color of other sections */
    --MENU-SECTIONS-LINK-color: #ccc; /* Color of links in menu */
    --MENU-SECTIONS-LINK-HOVER-color: #e6e6e6;  /* Color of links in menu, when hovered */
    --MENU-SECTION-ACTIVE-CATEGORY-color: #777; /* Color of active category text */
    --MENU-SECTION-ACTIVE-CATEGORY-BG-color: #fff; /* Color of background for the active category (only) */

    --MENU-VISITED-color: #33a1ff; /* Color of 'page visited' icons in menu */
    --MENU-SECTION-HR-color: #20272b; /* Color of <hr> separator in menu */
    
}

body {
    color: var(--MAIN-TEXT-color) !important;
}

textarea:focus, input[type="email"]:focus, input[type="number"]:focus, input[type="password"]:focus, input[type="search"]:focus, input[type="tel"]:focus, input[type="text"]:focus, input[type="url"]:focus, input[type="color"]:focus, input[type="date"]:focus, input[type="datetime"]:focus, input[type="datetime-local"]:focus, input[type="month"]:focus, input[type="time"]:focus, input[type="week"]:focus, select[multiple=multiple]:focus {
    border-color: none;
    box-shadow: none;
}

h2, h3, h4, h5 {
    color: var(--MAIN-TITLES-TEXT-color) !important;
}

a {
    color: var(--MAIN-LINK-color);
}

.anchor {
    color: var(--MAIN-ANCHOR-color);
}

a:hover {
    color: var(--MAIN-LINK-HOVER-color);
}

#sidebar ul li.visited > a .read-icon {
	color: var(--MENU-VISITED-color);
}

#body a.highlight:after {
    display: block;
    content: "";
    height: 1px;
    width: 0%;
    -webkit-transition: width 0.5s ease;
    -moz-transition: width 0.5s ease;
    -ms-transition: width 0.5s ease;
    transition: width 0.5s ease;
    background-color: var(--MAIN-LINK-HOVER-color);
}
#sidebar {
	background-color: var(--MENU-SECTIONS-BG-color);
}
#sidebar #header-wrapper {
    background: var(--MENU-HEADER-BG-color);
    color: var(--MENU-SEARCH-BOX-color);
    border-color: var(--MENU-HEADER-BORDER-color);
}
#sidebar .searchbox {
	border-color: var(--MENU-SEARCH-BOX-color);
    background: var(--MENU-SEARCH-BG-color);
}
#sidebar ul.topics > li.parent, #sidebar ul.topics > li.active {
    background: var(--MENU-SECTIONS-ACTIVE-BG-color);
}
#sidebar .searchbox * {
    color: var(--MENU-SEARCH-BOX-ICONS-color);
}

#sidebar a {
    color: var(--MENU-SECTIONS-LINK-color);
}

#sidebar a:hover {
    color: var(--MENU-SECTIONS-LINK-HOVER-color);
}

#sidebar ul li.active > a {
    background: var(--MENU-SECTION-ACTIVE-CATEGORY-BG-color);
    color: var(--MENU-SECTION-ACTIVE-CATEGORY-color) !important;
}

#sidebar hr {
    border-color: var(--MENU-SECTION-HR-color);
}

そして、config.tomlのパラメータでmineを設定します

[params]
  # Change default color scheme with a variant one. Can be "red", "blue", "green".
  themeVariant = "mine"

初期パラメータアイコン