From de3e44b7682cf96fdfbe789bc6dc713729bd75ab Mon Sep 17 00:00:00 2001 From: Dan Tsekhanskiy <28414793+TsekNet@users.noreply.github.com> Date: Tue, 30 Mar 2021 20:42:08 -0400 Subject: [PATCH 1/6] Fix capitalization of changelog link This link 404's. Updating to match `_config.yml` --- hydejack/_posts/2021-02-13-whats-new-in-hydejack-9-1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hydejack/_posts/2021-02-13-whats-new-in-hydejack-9-1.md b/hydejack/_posts/2021-02-13-whats-new-in-hydejack-9-1.md index d5118b121f..be9b0bf3d2 100644 --- a/hydejack/_posts/2021-02-13-whats-new-in-hydejack-9-1.md +++ b/hydejack/_posts/2021-02-13-whats-new-in-hydejack-9-1.md @@ -107,7 +107,7 @@ For more, see [the dedicated website](https://getclaps.app/). *** {:style="margin:2rem 0"} -There are many more changes and bugfixes in 9.1. See the [CHANGELOG](/changelog/){:.heading.flip-title} for details. +There are many more changes and bugfixes in 9.1. See the [CHANGELOG](/CHANGELOG/){:.heading.flip-title} for details. ## Credits From 64c8164e16160812711bd25e119bb5c943a25685 Mon Sep 17 00:00:00 2001 From: Florian Klampfer Date: Tue, 30 Nov 2021 13:51:04 +0700 Subject: [PATCH 2/6] Fix --- _config.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_config.yml b/_config.yml index bc48bc50f9..ecfceb42c0 100644 --- a/_config.yml +++ b/_config.yml @@ -81,7 +81,7 @@ paginate_path: /:num/ # --------------------------------------------------------------------------------------- theme: jekyll-theme-hydejack -# remote_theme: hydecorp/hydejack@v9.0.0-rc.6 +# remote_theme: hydecorp/hydejack@v9 # Customizaton From feaa84a1f64d8aa20a617b065cea8008ec50e1f0 Mon Sep 17 00:00:00 2001 From: Florian Klampfer Date: Tue, 30 Nov 2021 15:07:58 +0700 Subject: [PATCH 3/6] Fix gumroad --- _includes/my-head.html | 94 +++++++++++++++++++++--------------------- 1 file changed, 46 insertions(+), 48 deletions(-) diff --git a/_includes/my-head.html b/_includes/my-head.html index 0dcd5d0043..84c05a1031 100644 --- a/_includes/my-head.html +++ b/_includes/my-head.html @@ -8,56 +8,54 @@ const ppiData = window._ppiData = fetch('https://hydejack-ppi.qwtel.workers.dev', { mode: 'cors'}).then(res => res.json()).catch(() => ({})); const promisify = f => x => new Promise(r => f(x).addEventListener('load', r)); const loadJS = promisify(window.loadJS); - { - let p; - document.querySelector('hy-push-state').addEventListener('load', () => { - const io = new IntersectionObserver(async (entries) => { - if (entries.some(x => x.isIntersecting)) { - p = p || loadJS('https://gumroad.com/js/gumroad-embed.js'); - const [{ code }] = await Promise.all([ppiData, p]); - document.querySelectorAll('.gumroad-product-embed').forEach(el => { - if (!el.dataset.gumroadParams) { - el.dataset.gumroadParams = 'offer_code=' + (code || 'qr0tw8m'); - } - }); - if (!window.GumroadEmbed) { - await new Promise(function check1(res) { - if ('createGumroadEmbed' in window) res(window.createGumroadEmbed()); - else setTimeout(() => check1(res), 200); - }); + let p1, p2, embedCreated, overlayCreated; + + document.querySelector('hy-push-state').addEventListener('load', () => { + const io1 = new IntersectionObserver(async (entries) => { + if (entries.some(x => x.isIntersecting)) { + p1 = p1 || loadJS('https://gumroad.com/js/gumroad-embed.js'); + const [{ code }] = await Promise.all([ppiData, p1]); + document.querySelectorAll('.gumroad-product-embed').forEach(el => { + if (!el.dataset.gumroadParams) { + el.dataset.gumroadParams = 'offer_code=' + (code || 'qr0tw8m'); + } + }); + !embedCreated && await new Promise(function check1(res) { + if (typeof createGumroadEmbed !== 'undefined') { + embedCreated = 1; + res(createGumroadEmbed()); } - await new Promise(function check2(res) { - if ('GumroadEmbed' in window) res(GumroadEmbed.reload()); - else setTimeout(() => check2(res), 200); + else setTimeout(() => check1(res), 200); + }); + await new Promise(function check2(res) { + if (typeof GumroadEmbed !== 'undefined') res(GumroadEmbed.reload()); + else setTimeout(() => check2(res), 200); + }); + } + }, { rootMargin: '1440px' }); + + const io2 = new IntersectionObserver(async (entries) => { + if (entries.some(x => x.isIntersecting)) { + p2 = p2 || loadJS('https://gumroad.com/js/gumroad.js'); + const [{ code }] = await Promise.all([ppiData, p2]); + if (code) { + document.querySelectorAll('.gumroad-button').forEach(el => { + if (!el.href.endsWith(code)) { + el.href = el.href + '/' + (code || 'qr0tw8m'); + } }); } - }, { rootMargin: '1440px' }); - document.querySelectorAll('.gumroad-product-embed').forEach(el => io.observe(el)); - }); - } - { - let p; - document.querySelector('hy-push-state').addEventListener('load', () => { - const io = new IntersectionObserver(async (entries) => { - if (entries.some(x => x.isIntersecting)) { - p = p || loadJS('https://gumroad.com/js/gumroad.js'); - const [{ code }] = await Promise.all([ppiData, p]); - if (code) { - document.querySelectorAll('.gumroad-button').forEach(el => { - if (!el.href.endsWith(code)) { - el.href = el.href + '/' + (code || 'qr0tw8m'); - } - }); - } - if (!window.GumroadOverlay) { - await new Promise(function check(res) { - if ('createGumroadOverlay' in window) res(window.createGumroadOverlay()); - else setTimeout(() => check(res), 200); - }); + !overlayCreated && await new Promise(function check(res) { + if (typeof createGumroadOverlay !== 'undefined') { + overlayCreated = 1; + res(createGumroadOverlay()); } - } - }, { rootMargin: '300px' }); - document.querySelectorAll('.gumroad-button').forEach(el => io.observe(el)); - }); - } + else setTimeout(() => check(res), 200); + }); + } + }, { rootMargin: '300px' }); + + document.querySelectorAll('.gumroad-product-embed').forEach(el => io1.observe(el)); + document.querySelectorAll('.gumroad-button').forEach(el => io2.observe(el)); + }); From 4edbef0ce62c05b21d79bab4d1ae0528b8f92810 Mon Sep 17 00:00:00 2001 From: Florian Klampfer Date: Tue, 30 Nov 2021 15:08:06 +0700 Subject: [PATCH 4/6] Update lock --- Gemfile.lock | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Gemfile.lock b/Gemfile.lock index 1ac8bb0753..bbaea6d6ea 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -1,7 +1,7 @@ PATH remote: #jekyll-theme-hydejack specs: - jekyll-theme-hydejack (9.1.4) + jekyll-theme-hydejack (9.1.5) jekyll (>= 3.8, < 5.0) jekyll-include-cache (~> 0.2) From c6f285cca44a1f19845dd9be8cc15f569996e05d Mon Sep 17 00:00:00 2001 From: Florian Klampfer Date: Fri, 28 Jan 2022 11:47:15 +0700 Subject: [PATCH 5/6] Fixes --- .github/workflows/deploy.yml | 3 ++- _config.yml | 2 +- offline.md | 1 + 3 files changed, 4 insertions(+), 2 deletions(-) diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml index 6bdec2294d..2b5d944962 100644 --- a/.github/workflows/deploy.yml +++ b/.github/workflows/deploy.yml @@ -14,13 +14,14 @@ jobs: with: token: ${{ secrets.GH_REPO_PAT }} submodules: true + fetch-depth: 0 - uses: actions/cache@v2 with: path: vendor/bundle key: ${{ runner.os }}-gems-${{ hashFiles('**/Gemfile') }} restore-keys: | ${{ runner.os }}-gems- - - uses: helaili/jekyll-action@2.1.0 + - uses: helaili/jekyll-action@v2 with: token: ${{ secrets.GH_REPO_PAT }} jekyll_env: production diff --git a/_config.yml b/_config.yml index 6324314578..f6568ddae7 100644 --- a/_config.yml +++ b/_config.yml @@ -394,7 +394,7 @@ titles_from_headings: collections: true compress_html: - comments: [""] + comments: [""] clippings: all endings: all ignore: diff --git a/offline.md b/offline.md index 6b1ba80019..3d361f7bc6 100644 --- a/offline.md +++ b/offline.md @@ -1,4 +1,5 @@ --- layout: offline permalink: offline.html +sitemap: false --- \ No newline at end of file From 59020ce4441412bbafb9a358561d59456cda63a0 Mon Sep 17 00:00:00 2001 From: Florian Klampfer Date: Mon, 7 Feb 2022 11:32:16 +0700 Subject: [PATCH 6/6] Update content --- #jekyll-theme-hydejack | 2 +- CHANGELOG.md | 9 +++ Gemfile.lock | 18 ++--- _data/authors.yml | 4 +- docs/config.md | 2 +- docs/install.md | 4 +- docs/print.md | 169 ++++++++++++++++------------------------- docs/upgrade.md | 2 +- docs/writing.md | 30 -------- 9 files changed, 91 insertions(+), 149 deletions(-) diff --git a/#jekyll-theme-hydejack b/#jekyll-theme-hydejack index 25d52da566..e0a39ea054 160000 --- a/#jekyll-theme-hydejack +++ b/#jekyll-theme-hydejack @@ -1 +1 @@ -Subproject commit 25d52da566ddcc9557c883e3a05361221885333a +Subproject commit e0a39ea05422b64c54658de25a91339b11b71199 diff --git a/CHANGELOG.md b/CHANGELOG.md index 229bea2fb4..b562752b6b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,15 @@ layout: plain * this list will be replaced by the toc {:toc .large-only} +## v9.1.6 +Feb 07 2022 +{:.heading.post-date} + +* Removed unused clap button HTML tags +* Fixed an issue with using `featured` projects on the `welcome` layout +* Minor style adjustments +* Updated dependencies + ## v9.1.5 Nov 30 2021 {:.heading.post-date} diff --git a/Gemfile.lock b/Gemfile.lock index bbaea6d6ea..c3e4819614 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -1,7 +1,7 @@ PATH remote: #jekyll-theme-hydejack specs: - jekyll-theme-hydejack (9.1.5) + jekyll-theme-hydejack (9.1.6) jekyll (>= 3.8, < 5.0) jekyll-include-cache (~> 0.2) @@ -19,11 +19,11 @@ GEM eventmachine (1.2.7) eventmachine (1.2.7-x64-mingw32) execjs (2.8.1) - ffi (1.15.4) - ffi (1.15.4-x64-mingw32) + ffi (1.15.5) + ffi (1.15.5-x64-mingw32) forwardable-extended (2.6.0) http_parser.rb (0.8.0) - i18n (1.8.11) + i18n (1.9.1) concurrent-ruby (~> 1.0) jekyll (4.2.1) addressable (~> 2.4) @@ -44,7 +44,7 @@ GEM jekyll (>= 3.7, < 5.0) jekyll-default-layout (0.1.5) jekyll (>= 3.0, < 5.0) - jekyll-feed (0.15.1) + jekyll-feed (0.16.0) jekyll (>= 3.7, < 5.0) jekyll-include-cache (0.2.1) jekyll (>= 3.7, < 5.0) @@ -62,7 +62,7 @@ GEM jekyll (>= 3.3, < 5.0) jekyll-sass-converter (2.1.0) sassc (> 2.0.1, < 3.0) - jekyll-seo-tag (2.7.1) + jekyll-seo-tag (2.8.0) jekyll (>= 3.8, < 5.0) jekyll-sitemap (1.4.0) jekyll (>= 3.7, < 5.0) @@ -80,7 +80,7 @@ GEM kramdown-parser-gfm (1.1.0) kramdown (~> 2.0) liquid (4.0.3) - listen (3.7.0) + listen (3.7.1) rb-fsevent (~> 0.10, >= 0.10.3) rb-inotify (~> 0.9, >= 0.9.10) mercenary (0.4.0) @@ -88,11 +88,11 @@ GEM forwardable-extended (~> 2.6) posix-spawn (0.3.15) public_suffix (4.0.6) - rb-fsevent (0.11.0) + rb-fsevent (0.11.1) rb-inotify (0.10.1) ffi (~> 1.0) rexml (3.2.5) - rouge (3.26.1) + rouge (3.28.0) safe_yaml (1.0.5) sassc (2.4.0) ffi (~> 1.9) diff --git a/_data/authors.yml b/_data/authors.yml index 57190495e9..4733524d4b 100644 --- a/_data/authors.yml +++ b/_data/authors.yml @@ -55,7 +55,7 @@ qwtel: [fea]: /#features [pro]: /download/ - [kit]: https://github.com/hydecorp/hydejack-starter-kit/archive/v9.1.5.zip + [kit]: https://github.com/hydecorp/hydejack-starter-kit/archive/v9.1.6.zip [nfy]: https://app.netlify.com/start/deploy?repository=https://github.com/hydecorp/hydejack-starter-kit [dtn]: https://www.netlify.com/img/deploy/button.svg [buy]: https://gum.co/nuOluY @@ -75,7 +75,7 @@ qwtel: twitter: hydecorp github: https://github.com/hydecorp/hydejack email: mail@qwtel.com - download: https://github.com/hydecorp/hydejack-starter-kit/archive/v9.1.5.zip + download: https://github.com/hydecorp/hydejack-starter-kit/archive/v9.1.6.zip # Another author mdo: diff --git a/docs/config.md b/docs/config.md index f42c7fdbea..a030221705 100644 --- a/docs/config.md +++ b/docs/config.md @@ -343,7 +343,7 @@ author: social: email: mail@qwtel.com rss: {{ site.url }}{{ site.baseurl }}/feed.xml # make sure you provide an absolute URL - download: https://github.com/hydecorp/hydejack/archive/v9.1.5.zip + download: https://github.com/hydecorp/hydejack/archive/v9.1.6.zip ~~~ diff --git a/docs/install.md b/docs/install.md index fd9a3e3736..b44f42852f 100644 --- a/docs/install.md +++ b/docs/install.md @@ -31,7 +31,7 @@ You can now also [![Deploy to Netlify][dtn]][nfy]{:.no-mark-external} directly. {:.note} [hsc]: https://github.com/hydecorp/hydejack-starter-kit -[src]: https://github.com/hydecorp/hydejack-starter-kit/archive/v9.1.5.zip +[src]: https://github.com/hydecorp/hydejack-starter-kit/archive/v9.1.6.zip [nfy]: https://app.netlify.com/start/deploy?repository=https://github.com/hydecorp/hydejack-starter-kit [dtn]: https://www.netlify.com/img/deploy/button.svg @@ -92,7 +92,7 @@ For existing sites, you can instead set the `remote_theme` key as follows: ```yml # file: `_config.yml` -remote_theme: hydecorp/hydejack@v9.1.5 +remote_theme: hydecorp/hydejack@v9.1.6 ``` Make sure the `plugins` list contains `jekyll-include-cache` (create if it doesn't exist): diff --git a/docs/print.md b/docs/print.md index 6d90dc0ad8..88d4bca0f7 100644 --- a/docs/print.md +++ b/docs/print.md @@ -57,7 +57,7 @@ You can now also [![Deploy to Netlify][dtn]][nfy]{:.no-mark-external} directly. {:.note} [hsc]: https://github.com/hydecorp/hydejack-starter-kit -[src]: https://github.com/hydecorp/hydejack-starter-kit/archive/v9.1.5.zip +[src]: https://github.com/hydecorp/hydejack-starter-kit/archive/v9.1.6.zip [nfy]: https://app.netlify.com/start/deploy?repository=https://github.com/hydecorp/hydejack-starter-kit [dtn]: https://www.netlify.com/img/deploy/button.svg @@ -118,7 +118,7 @@ For existing sites, you can instead set the `remote_theme` key as follows: ```yml ## file: `_config.yml` -remote_theme: hydecorp/hydejack@v9.1.5 +remote_theme: hydecorp/hydejack@v9.1.6 ``` Make sure the `plugins` list contains `jekyll-include-cache` (create if it doesn't exist): @@ -213,7 +213,7 @@ and you have to apply them again. Make sure you've made a backup before overwrit When building on GitHub Pages, upgrading Hydejack is as simple as setting the `remote_theme` key in `_config.yml` to the desired version. ```yml -remote_theme: hydecorp/hydejack@v9.1.5 +remote_theme: hydecorp/hydejack@v9.1.6 ``` To use the latest version on the `v9` branch on each build, you can use `hydecorp/hydejack@v9`. @@ -245,6 +245,9 @@ The `url` is the domain of your site, including the protocol (`http` or `https`) url: https://qwtel.com ~~~ +You don't need to provide this property when hosting on GitHub Pages or Netlify. +{:.note} + If your entire Jekyll blog is hosted in a subdirectory of your page, provide the path in `baseurl` with a leading `/`, but no trailing `/`, e.g. @@ -255,6 +258,8 @@ baseurl: /hydejack Otherwise, provide the empty string `''` +You don't need to provide this property when hosting on GitHub Pages or Netlify. +{:.note} #### GitHub Pages When hosting on [GitHub Pages](https://pages.github.com/) the `url` is `https://.github.io` @@ -285,8 +290,12 @@ If you save a blurred image as JPG, it will also drastically reduce its file siz The `accent_image` property also accepts the special value `none` which will remove the default image. -Note that these values can be overwritte on a per-page basis, i.e. you can create a unique look for each page. -You can also apply a certain look all posts in a category via [front matter defaults][fmd], e.g.: +If your sidebar image contains bright colors, the white text can be difficult to read. In this case, consider setting +`invert_sidebar: true` in the front matter to invert the text colors in the sidebar. +Use [front matter defaults][fmd] to enable this on all pages (see below). + +Note that these values can be overwritten on a per-page basis, i.e. you can create a unique look for each page. +You can also apply a certain look to all posts in a category via [front matter defaults][fmd], e.g.: ```yml ## file: `_config.yml` @@ -553,7 +562,7 @@ author: social: email: mail@qwtel.com rss: {{ site.url }}{{ site.baseurl }}/feed.xml # make sure you provide an absolute URL - download: https://github.com/hydecorp/hydejack/archive/v9.1.5.zip + download: https://github.com/hydecorp/hydejack/archive/v9.1.6.zip ~~~ @@ -674,10 +683,10 @@ There are a couple of things to know about this gem: * It is not supported on GitHub Pages. You have to build the site on your machine before uploading to GitHub, or use a more permissive cloud building tool such as Netlify. - See [the section below](#mathjax) for an alternative. * You need some kind of JavaScript runtime on your machine. Usually installing [NodeJS](https://nodejs.org/en/download/) will suffice. - For details, see + Alternatively, adding `gem "duktape"` will also do. + For more, see Before you add math content, remember to run `bundle install` and restart Jekyll. @@ -685,7 +694,19 @@ Before you add math content, remember to run `bundle install` and restart Jekyll [katex]: https://khan.github.io/KaTeX/ [mathjax]: https://www.mathjax.org/ -### Adding custom favicons and app icons + +### Adding custom Favicons and App Icons +#### Changing the Favicon +By default, Hydejack will use the Favicon from `/assets/icons/favicon.ico` and Apple Touch Icon from `/assets/icons/icon-192x192.png`. +You can either override these files, or override the path in the config file via `favicon` and `app_touch_icon` keys: + +```yml +## file: "_config.yml" +favicon: /favicon.ico +apple_touch_icon: /assets/img/logo.png +``` + +#### Changing the App Icons By default, Hydejack includes its own favicon, as well as app icons in 8 different resolutions. | Name | Resolution | @@ -985,7 +1006,7 @@ Some content ### Adding a cover page Hydejack 8 introduces cover pages, i.e. pages witht he sidebar opened, so that it spans the entire screen. This feature is intended for landing pages. To enable it on a page, simply add `cover: true` to the front matter. -![Cover page example](../assets/img/blog/hydejack-8@0,5x.png){:width="960" height="540"} +![Cover page example](../assets/img/blog/hydejack-8@0,5x.png){:.lead width="960" height="540" loading="lazy"} ~~~yml ## file: `index.md` @@ -1301,11 +1322,8 @@ If a keyword is not recognized, the provided text will be spelled out instead. ~~~yml ## file: `resume.md` ---- -layout: resume no_language_icons: true no_skill_icons: true ---- ~~~ #### Adding a specialized resume or multiple resumes @@ -1328,25 +1346,30 @@ resume: --- ~~~ - + json: /assets/resume.json +``` -Downloads currently aren't supported when using multiple resumes. Use the `no_buttons` option to avoid confusion. -{:.note} +To remove a button remove the corresponding key from the hash. -``` -├── assets -│ └── Resume.pdf -``` +While the `resume.json` is can be generated by Jekyll itself, and the vCard can be generated by an [external service][h2vx], +the PDF needs to be pre-generated by you. -You can generate the `Resume.pdf` from your resume page itself. -Use your browser's "Print to PDF" feature (Chrome works best). +You can render a PDF from the resume page itself by using your browser's "Print to PDF" feature (Chrome works best). For best results, check the following options in the print popup: -![Uncheck Headers and footers, check Background graphics](/assets/img/docs/chrome-print.png){:width="299" height="588" loading="lazy"} --> +[h2vx]: http://h2vx.com/vcf/ + +![Uncheck Headers and footers, check Background graphics](/assets/img/docs/chrome-print.png){:width="299" height="588" loading="lazy"} @@ -1465,11 +1488,11 @@ You can make an image span the full width by adding the `lead` class. Example: -![Full-width image](https://placehold.it/800x100){:.lead width="800" height="100" loading="lazy"} +![Full-width image](https://via.placeholder.com/800x100){:.lead width="800" height="100" loading="lazy"} Markdown: ~~~markdown -![Full-width image](https://placehold.it/800x100){:.lead width="800" height="100" loading="lazy"} +![Full-width image](https://via.placeholder.com/800x100){:.lead width="800" height="100" loading="lazy"} ~~~ It is recommended to provide the dimension of the image via the `width` and `height` attributes, @@ -1483,14 +1506,14 @@ but it has been removed in v9 in favor of this more standards-based approach. ### Adding image captions You can add captions to large images by adding the `figcaption` class to the paragraph after the image: -![Full-width image](https://placehold.it/800x100){:.lead width="800" height="100" loading="lazy"} +![Full-width image](https://via.placeholder.com/800x100){:.lead width="800" height="100" loading="lazy"} An optional caption for an image. {:.figcaption} Markdown: ~~~md -![Full-width image](https://placehold.it/800x100){:.lead width="800" height="100" loading="lazy"} +![Full-width image](https://via.placeholder.com/800x100){:.lead width="800" height="100" loading="lazy"} A caption for an image. {:.figcaption} @@ -1549,7 +1572,12 @@ In this case, Hydejack will break the layout and grant the table the entire avai | Third line |quux | baz | bar | Third line |quux | baz | bar | Third line |quux | baz | bar | Third line |quux | baz | bar | | Second body | | | | Second body | | | | Second body | | | | Second body | | | | | 2 line | | | | 2 line | | | | 2 line | | | | 2 line | | | | +|=================|============|=================|================|=================|============|=================|================|=================|============|=================|================|=================|============|=================|================| | Footer row | | | | Footer row | | | | Footer row | | | | Footer row | | | | +{:.smaller} + +Tables adopts to the font size! You can decrease the size of the table by adding the `smaller` CSS class. Put `{:.smaller}` below the Markdown table, or add `class="smaller"` to a HTML table. +{:.note} #### Scroll table If the extra space still isn't enough, the table will receive a scrollbar. @@ -1563,40 +1591,13 @@ By adding the `scroll-table` class on a table, the behavior is changed to never | Third line |quux | baz | bar | Third line |quux | baz | bar | Third line |quux | baz | bar | Third line |quux | baz | bar | | Second body | | | | Second body | | | | Second body | | | | Second body | | | | | 2 line | | | | 2 line | | | | 2 line | | | | 2 line | | | | +|=================|============|=================|================|=================|============|=================|================|=================|============|=================|================|=================|============|=================|================| | Footer row | | | | Footer row | | | | Footer row | | | | Footer row | | | | -{:.scroll-table} +{:.smaller.scroll-table} You can add the `scroll-table` class to a markdown table by putting `{:.scroll-table}` in line directly below the table. To add the class to a HTML table, add the it to the `class` attribute of the `table` tag, e.g. ``. -#### Flip table -Alternatively, you can "flip" (transpose) the table. -Unlike the other approach, this will keep the table head (now the first column) fixed in place. - -You can enable this behavior by adding `flip-table` or `flip-table-small` to the CSS classes of the table. -The `-small` version will only enable scrolling on "small" screens (< 1080px wide). - -This approach only works on simple tables that have a single `tbody` and an optional `thead`. -{:.note} - -Example: - -| Default aligned |Left aligned| Center aligned | Right aligned | Default aligned |Left aligned| Center aligned | Right aligned | Default aligned |Left aligned| Center aligned | Right aligned | Default aligned |Left aligned| Center aligned | Right aligned | -|-----------------|:-----------|:---------------:|---------------:|-----------------|:-----------|:---------------:|---------------:|-----------------|:-----------|:---------------:|---------------:|-----------------|:-----------|:---------------:|---------------:| -| First body part |Second cell | Third cell | fourth cell | First body part |Second cell | Third cell | fourth cell | First body part |Second cell | Third cell | fourth cell | First body part |Second cell | Third cell | fourth cell | -| Second line |foo | **strong** | baz | Second line |foo | **strong** | baz | Second line |foo | **strong** | baz | Second line |foo | **strong** | baz | -| Third line |quux | baz | bar | Third line |quux | baz | bar | Third line |quux | baz | bar | Third line |quux | baz | bar | -| 4th line |quux | baz | bar | 4th line |quux | baz | bar | 4th line |quux | baz | bar | 4th line |quux | baz | bar | -| 5th line |quux | baz | bar | 5th line |quux | baz | bar | 5th line |quux | baz | bar | 5th line |quux | baz | bar | -| 6th line |quux | baz | bar | 6th line |quux | baz | bar | 6th line |quux | baz | bar | 6th line |quux | baz | bar | -| 7th line |quux | baz | bar | 7th line |quux | baz | bar | 7th line |quux | baz | bar | 7th line |quux | baz | bar | -| 8th line |quux | baz | bar | 8th line |quux | baz | bar | 8th line |quux | baz | bar | 8th line |quux | baz | bar | -| 9th line |quux | baz | bar | 9th line |quux | baz | bar | 9th line |quux | baz | bar | 9th line |quux | baz | bar | -| 10th line |quux | baz | bar | 10th line |quux | baz | bar | 10th line |quux | baz | bar | 10th line |quux | baz | bar | -{:.flip-table} - -You can add the `flip-table` class to a markdown table by putting `{:.flip-table}` in line directly below the table. -To add the class to a HTML table, add the it to the `class` attribute of the `table` tag, e.g. `
`. #### Small tables If a table is small enough to fit the screen even on small screens, you can add the `stretch-table` class @@ -1626,12 +1627,12 @@ To add a code block without syntax highlighting, simply indent 4 spaces (regular For code blocks with code highlighting, use `~~~`. This syntax is also supported by GitHub. For more information and a list of supported languages, see [Rouge](http://rouge.jneen.net/). - +You can give each code block a filename, by making the first line in the block a comment of the form `File: "dir/filename.ext"`. Use either single quotes `'`, double quotes `"`, or backticks ` to surround the filename. Example: ~~~js -// title: "code-block.js" +// file: "code-block.js" // Example can be run directly in your JavaScript console // Create a function that takes two arguments and returns the sum of those @@ -1649,7 +1650,7 @@ An optional caption for a code block Markdown: ~~~js - // title: "code-block.js" + // file: "code-block.js" // Example can be run directly in your JavaScript console // Create a function that takes two arguments and returns the sum of those @@ -1714,7 +1715,7 @@ Markdown: ~~~latex $$ -\begin{aligned} +\begin{aligned} %!!15 \phi(x,y) &= \phi \left(\sum_{i=1}^n x_ie_i, \sum_{j=1}^n y_je_j \right) \\[2em] &= \sum_{i=1}^n \sum_{j=1}^n x_i y_j \phi(e_i, e_j) \\[2em] &= (x_1, \ldots, x_n) @@ -1956,7 +1957,7 @@ To enable this feature, create a `sw.js` file in the root of your project and ad ```js --- --- -importScripts("{% raw %}{{ '/assets/js/service-worker.js' | relative_url }}?t={{ site.time | date_to_xmlschema }}{% endraw %}"); +importScripts("{% raw %}{{ '/assets/js/sw.js' | relative_url }}?t={{ site.time | date_to_xmlschema }}{% endraw %}"); ``` This will load the main service worker script from Hydejack's assets. The `site.time` part is necessary to make the service worker "byte different" every time you create a new build of your site, which triggers an update. @@ -2089,7 +2090,7 @@ The rules are as follows: * Every line that isn't contained in a block and ends with `// link` will be linked * Every line for which none of the above applies will be included in both. -The actual splitting happen with the `_scripts/build-css.sh` script (requires node.js 8+). +The actual splitting happen with the `.scripts/build-css.sh` script (requires node.js 8+). You can run the script once by using ~~~bash @@ -2114,42 +2115,4 @@ hydejack: to your config file. -### Building the JavaScript -In order to build the JavaScript you need to have [node.js](https://nodejs.org/en/) installed. Specifically, the `npm` command needs to be available, which is part of node.js. - -Building the JavaScript is optional! Hydejack comes with a pre-built, minified `hydejack.js` file -that you can find in part of the theme's `assets`. -{:.note} - -Before you start, make sure you've copied the following files: -* `_js/` -* `package.json` -* `package-lock.json` -* `.babelrc` -* `.eslintignore` -* `.eslintrc` - -When building for the first time (and after each update of Hydejack) you have to run - -~~~bash -$ npm install -~~~ - -to fetch all dependencies (and put them in a local folder `node_modules`), lint the code and write the bundled and minified script into `assets/js/hydejack.js`. - -You can re-build it with - -~~~bash -$ npm run build:js -~~~ - -If you want to actively develop the scripts, it is better to run - -~~~bash -$ npm run watch:js -~~~ - -which will build a non-minified version of `assets/js/hydejack.js` after each filechange. - - *[FLIP]: First Last Invert Play \ No newline at end of file diff --git a/docs/upgrade.md b/docs/upgrade.md index c18ba45068..6cbeb3381b 100644 --- a/docs/upgrade.md +++ b/docs/upgrade.md @@ -43,7 +43,7 @@ and you have to apply them again. Make sure you've made a backup before overwrit When building on GitHub Pages, upgrading Hydejack is as simple as setting the `remote_theme` key in `_config.yml` to the desired version. ```yml -remote_theme: hydecorp/hydejack@v9.1.5 +remote_theme: hydecorp/hydejack@v9.1.6 ``` To use the latest version on the `v9` branch on each build, you can use `hydecorp/hydejack@v9`. diff --git a/docs/writing.md b/docs/writing.md index d86fd77654..37be6d3aa9 100644 --- a/docs/writing.md +++ b/docs/writing.md @@ -216,36 +216,6 @@ By adding the `scroll-table` class on a table, the behavior is changed to never You can add the `scroll-table` class to a markdown table by putting `{:.scroll-table}` in line directly below the table. To add the class to a HTML table, add the it to the `class` attribute of the `table` tag, e.g. `
`. -### Flip table -Alternatively, you can "flip" (transpose) the table. -Unlike the other approach, this will keep the table head (now the first column) fixed in place. - -You can enable this behavior by adding `flip-table` or `flip-table-small` to the CSS classes of the table. -The `-small` version will only enable scrolling on "small" screens (< 1080px wide). - -This approach only works on simple tables that have a single `tbody` and an optional `thead`. -{:.note} - -Example: - -| Default aligned |Left aligned| Center aligned | Right aligned | Default aligned |Left aligned| Center aligned | Right aligned | Default aligned |Left aligned| Center aligned | Right aligned | Default aligned |Left aligned| Center aligned | Right aligned | -|-----------------|:-----------|:---------------:|---------------:|-----------------|:-----------|:---------------:|---------------:|-----------------|:-----------|:---------------:|---------------:|-----------------|:-----------|:---------------:|---------------:| -| First body part |Second cell | Third cell | fourth cell | First body part |Second cell | Third cell | fourth cell | First body part |Second cell | Third cell | fourth cell | First body part |Second cell | Third cell | fourth cell | -| Second line |foo | **strong** | baz | Second line |foo | **strong** | baz | Second line |foo | **strong** | baz | Second line |foo | **strong** | baz | -| Third line |quux | baz | bar | Third line |quux | baz | bar | Third line |quux | baz | bar | Third line |quux | baz | bar | -| 4th line |quux | baz | bar | 4th line |quux | baz | bar | 4th line |quux | baz | bar | 4th line |quux | baz | bar | -| 5th line |quux | baz | bar | 5th line |quux | baz | bar | 5th line |quux | baz | bar | 5th line |quux | baz | bar | -| 6th line |quux | baz | bar | 6th line |quux | baz | bar | 6th line |quux | baz | bar | 6th line |quux | baz | bar | -| 7th line |quux | baz | bar | 7th line |quux | baz | bar | 7th line |quux | baz | bar | 7th line |quux | baz | bar | -| 8th line |quux | baz | bar | 8th line |quux | baz | bar | 8th line |quux | baz | bar | 8th line |quux | baz | bar | -| 9th line |quux | baz | bar | 9th line |quux | baz | bar | 9th line |quux | baz | bar | 9th line |quux | baz | bar | -| 10th line |quux | baz | bar | 10th line |quux | baz | bar | 10th line |quux | baz | bar | 10th line |quux | baz | bar | -| 11th line |quux | baz | bar | 11th line |quux | baz | bar | 11th line |quux | baz | bar | 11th line |quux | baz | bar | -| 12th line |quux | baz | bar | 12th line |quux | baz | bar | 12th line |quux | baz | bar | 12th line |quux | baz | bar | -{:.smaller.flip-table} - -You can add the `flip-table` class to a markdown table by putting `{:.flip-table}` in line directly below the table. -To add the class to a HTML table, add the it to the `class` attribute of the `table` tag, e.g. `
`. ### Small tables If a table is small enough to fit the screen even on small screens, you can add the `stretch-table` class