mirror of
https://github.com/SharpeTronics/jekyll-spaceship.git
synced 2025-06-24 00:01:24 -04:00
Compare commits
No commits in common. "master" and "v0.2.1" have entirely different histories.
@ -1,38 +0,0 @@
|
||||
version: "2"
|
||||
checks:
|
||||
argument-count:
|
||||
enabled: true
|
||||
config:
|
||||
threshold: 5
|
||||
file-lines:
|
||||
enabled: true
|
||||
config:
|
||||
threshold: 300
|
||||
method-complexity:
|
||||
enabled: true
|
||||
config:
|
||||
threshold: 15
|
||||
method-count:
|
||||
enabled: true
|
||||
config:
|
||||
threshold: 50
|
||||
method-lines:
|
||||
enabled: true
|
||||
config:
|
||||
threshold: 30
|
||||
plugins:
|
||||
fixme:
|
||||
enabled: false
|
||||
|
||||
exclude_patterns:
|
||||
- "*.*"
|
||||
- ".*"
|
||||
|
||||
- Gemfile
|
||||
- LICENSE.txt
|
||||
- Rakefile
|
||||
|
||||
- rake/
|
||||
- script/
|
||||
- spec/
|
||||
- test/
|
||||
12
.github/FUNDING.yml
vendored
12
.github/FUNDING.yml
vendored
@ -1,12 +0,0 @@
|
||||
# These are supported funding model platforms
|
||||
|
||||
github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
|
||||
patreon: jeffreytse
|
||||
open_collective: # Replace with a single Open Collective username
|
||||
ko_fi: jeffreytse
|
||||
tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
|
||||
community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
|
||||
liberapay: jeffreytse
|
||||
issuehunt: # Replace with a single IssueHunt username
|
||||
otechie: # Replace with a single Otechie username
|
||||
custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
|
||||
34
.travis.yml
34
.travis.yml
@ -1,34 +0,0 @@
|
||||
language: ruby
|
||||
cache: bundler
|
||||
rvm:
|
||||
- 2.7
|
||||
- 2.3
|
||||
env:
|
||||
global:
|
||||
- NOKOGIRI_USE_SYSTEM_LIBRARIES=true
|
||||
matrix:
|
||||
- JEKYLL_VERSION="~> 3.8"
|
||||
matrix:
|
||||
include:
|
||||
- rvm: 2.7
|
||||
env: JEKYLL_VERSION="~> 3.8.6"
|
||||
- rvm: 2.7
|
||||
env: JEKYLL_VERSION=">= 4.0.0"
|
||||
before_install:
|
||||
- gem update --system
|
||||
- gem install bundler
|
||||
before_script: bundle update
|
||||
script: script/cibuild
|
||||
notifications:
|
||||
email: false
|
||||
deploy:
|
||||
provider: rubygems
|
||||
api_key:
|
||||
secure: AqjHemFJsIxFuudjWzYbUGBpA5wpAB9Ate6oDZMGMnpaoSD2VgfkBDklyFfEh5uuHrh+rU6U9MPv4wknXVIV7gTTY18ATgzciLa+JCVjhAaSoPGSkORT15/kKpVp4IXIoEytj5T9D+8Wc8czd/B1+lMGGu7n7d7gMvg0HsjOLzJtAOYPrRUTaTXDLeIA+rPnsI1IzbvfHzcZvuD70XkBJWN9kiu0djlI6o51XQNumWMJrFAD/NDD3h3tZ0kkI0TalAYbWVRkZ/ZeABKAod3IRAXGt4L2MM2eYqE5KaXb/GE5wISib3I/iTCjjwrNlM+wM9a+mnOkC+elaCJm1LENqP5Ocy9wbOLYmC8i1VpPDXm2bskbj32oy1wf5zeQUf6bnPB+wDmwgCirYb7z2jQlV4BzRRkDCTftfNTa8FIi03kf+i7phjHuj18j/JC3Ww1ApRq71JAuqEnUY0wBaaN3M5abrJsYOxCRnYVPcBn/w8gfkXuhv9xvDG2OgwqIjDiECPjmbeK8Apo9kgKSrfjBQ43q62Ore6SuVCS+PZOOxVnHmfphfT4xc1atyVeMLkSvnWOa/sWTwgOSXqt1TYAEEhb734AsfXeRMzxU/LN1Y4nZ0otuEv+HVHA/XeHLA1Skq9vHhtZaORhJ58Jmwv5oMwA8KC/wPrn0gGtSBPe8zxw=
|
||||
gem: jekyll-spaceship
|
||||
on:
|
||||
rvm: 2.3
|
||||
tags: true
|
||||
repo: jeffreytse/jekyll-spaceship
|
||||
edge: true
|
||||
cleanup: false
|
||||
752
README.md
752
README.md
@ -1,133 +1,27 @@
|
||||
<h1 align="center">
|
||||
<a href="https://github.com/jeffreytse/jekyll-spaceship">
|
||||
<img alt="spaceship →~ jekyll" src="https://raw.githubusercontent.com/jeffreytse/jekyll-spaceship/master/logos/jekyll-spaceship-logo.png" width="400">
|
||||
</a>
|
||||
<br> 🚀 Jekyll Spaceship 🚀 <br>
|
||||
</h1>
|
||||
# jekyll-spaceship
|
||||
|
||||
<h4 align="center">
|
||||
<a href="https://jekyllrb.org" target="_blank"><code>Jekyll</code></a> plugin for Astronauts.
|
||||
</h4>
|
||||
|
||||
<p align="center">
|
||||
|
||||
<a href="https://travis-ci.org/jeffreytse/jekyll-spaceship">
|
||||
<img src="https://travis-ci.org/jeffreytse/jekyll-spaceship.svg?branch=master"
|
||||
alt="CI Status" />
|
||||
</a>
|
||||
|
||||
<a href="http://badge.fury.io/rb/jekyll-spaceship">
|
||||
<img src="https://badge.fury.io/rb/jekyll-spaceship.svg"
|
||||
alt="Gem Version" />
|
||||
</a>
|
||||
|
||||
<a href="https://codeclimate.com/github/jeffreytse/jekyll-spaceship">
|
||||
<img src="https://codeclimate.com/github/jeffreytse/jekyll-spaceship/badges/gpa.svg"
|
||||
alt="Code Climate" />
|
||||
</a>
|
||||
|
||||
<a href="https://codeclimate.com/github/jeffreytse/jekyll-spaceship/test_coverage">
|
||||
<img src="https://api.codeclimate.com/v1/badges/cd56b207f327603662a1/test_coverage"
|
||||
alt="Test Coverage" />
|
||||
</a>
|
||||
|
||||
<a href="https://github.com/jeffreytse/jekyll-spaceship/blob/master/LICENSE.txt">
|
||||
<img src="https://img.shields.io/badge/License-MIT-brightgreen.svg"
|
||||
alt="License" />
|
||||
</a>
|
||||
|
||||
<a href="http://badge.fury.io/rb/jekyll-spaceship">
|
||||
<img src="https://img.shields.io/gem/dt/jekyll-spaceship"
|
||||
alt="Download Data" />
|
||||
</a>
|
||||
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
|
||||
<a href="https://liberapay.com/jeffreytse">
|
||||
<img src="http://img.shields.io/liberapay/goal/jeffreytse.svg?logo=liberapay"
|
||||
alt="Donate (Liberapay)" />
|
||||
</a>
|
||||
|
||||
<a href="https://patreon.com/jeffreytse">
|
||||
<img src="https://img.shields.io/badge/support-patreon-F96854.svg?style=flat-square"
|
||||
alt="Donate (Patreon)" />
|
||||
</a>
|
||||
|
||||
<a href="https://ko-fi.com/jeffreytse">
|
||||
<img height="20" src="https://www.ko-fi.com/img/githubbutton_sm.svg"
|
||||
alt="Donate (Ko-fi)" />
|
||||
</a>
|
||||
|
||||
</p>
|
||||
|
||||
<div align="center">
|
||||
<h4>
|
||||
<a href="#installation">Install</a> |
|
||||
<a href="#configuration">Config</a> |
|
||||
<a href="#usage">Usage</a> |
|
||||
<a href="#credits">Credits</a> |
|
||||
<a href="#license">License</a>
|
||||
</h4>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<sub>Built with ❤︎ by
|
||||
<a href="https://jeffreytse.net">jeffreytse</a> and
|
||||
<a href="https://github.com/jeffreytse/jekyll-spaceship/graphs/contributors">contributors </a>
|
||||
</div>
|
||||
<br>
|
||||
|
||||
|
||||
Spaceship is a minimalistic, powerful and extremely customizable [Jekyll](https://jekyllrb.com/) plugin. It combines everything you may need for convenient work, without unnecessary complications, like a real spaceship.
|
||||
|
||||
<p align="center">
|
||||
<img alt="Jekyll Spaceship Demo" src="https://user-images.githubusercontent.com/9413601/82250463-15451780-997e-11ea-8809-f411586d9508.gif" />
|
||||
</p>
|
||||
|
||||
**💡 Tip:** I hope you enjoy using this plugin. If you like this project, **a little star** for it is your way make a clear statement: **My work is valued**. I would appreciate your support! _Thank you!_
|
||||
[](https://travis-ci.org/jeffreytse/jekyll-spaceship)
|
||||
[](http://badge.fury.io/rb/jekyll-spaceship)
|
||||
[](https://codeclimate.com/github/jeffreytse/jekyll-spaceship)
|
||||
[](https://codeclimate.com/github/jeffreytse/jekyll-spaceship/test_coverage)
|
||||
|
||||
A Jekyll plugin to provide powerful supports for table, mathjax, plantuml, etc.
|
||||
|
||||
## Table of Contents
|
||||
|
||||
- [Requirements](#requirements)
|
||||
- [Installation](#installation)
|
||||
- [Configuration](#configuration)
|
||||
- [Usage](#usage)
|
||||
- [1. Table Usage](#1-table-usage)
|
||||
- [1.1 Rowspan and Colspan](#rowspan-and-colspan)
|
||||
- [1.2 Multiline](#multiline)
|
||||
- [1.3 Headerless](#headerless)
|
||||
- [1.4 Cell Alignment](#cell-alignment)
|
||||
- [1.5 Cell Markdown](#cell-markdown)
|
||||
- [1.6 Cell Inline Attributes](#cell-inline-attributes)
|
||||
- [2. MathJax Usage](#2-mathjax-usage)
|
||||
- [2.1 Performance Optimization](#21-performance-optimization)
|
||||
- [2.2 How to use?](#22-how-to-use)
|
||||
- [3. PlantUML Usage](#3-plantuml-usage)
|
||||
- [4. Mermaid Usage](#4-mermaid-usage)
|
||||
- [5. Media Usage](#5-media-usage)
|
||||
- [5.1 Youtube Usage](#youtube-usage)
|
||||
- [5.2 Vimeo Usage](#vimeo-usage)
|
||||
- [5.3 DailyMotion Usage](#dailymotion-usage)
|
||||
- [5.4 Spotify Usage](#spotify-usage)
|
||||
- [5.5 SoundCloud Usage](#soundcloud-usage)
|
||||
- [5.6 General Video Usage](#general-video-usage)
|
||||
- [5.7 General Audio Usage](#general-audio-usage)
|
||||
- [6. Hybrid HTML with Markdown](#6-hybrid-html-with-markdown)
|
||||
- [7. Markdown Polyfill](#7-markdown-polyfill)
|
||||
- [7.1 Escape Ordered List](#71-escape-ordered-list)
|
||||
- [8. Emoji Usage](#8-emoji-usage)
|
||||
- [8.1 Emoji Customizing](#81-emoji-customizing)
|
||||
- [9. Modifying Element Usage](#9-modifying-element-usage)
|
||||
- [Credits](#credits)
|
||||
- [Contributing](#contributing)
|
||||
- [License](#license)
|
||||
|
||||
## Requirements
|
||||
|
||||
- Ruby >= 2.3.0
|
||||
|
||||
## Installation
|
||||
|
||||
@ -137,109 +31,40 @@ Add jekyll-spaceship plugin in your site's `Gemfile`, and run `bundle install`.
|
||||
gem 'jekyll-spaceship'
|
||||
```
|
||||
|
||||
Add jekyll-spaceship to the `plugins:` section in your site's `_config.yml`.
|
||||
Add jekyll-spaceship to the `gems:` section in your site's `_config.yml`.
|
||||
|
||||
```yml
|
||||
plugins:
|
||||
- jekyll-spaceship
|
||||
```
|
||||
|
||||
**💡 Tip:** Note that GitHub Pages runs in `safe` mode and only allows [a set of whitelisted plugins](https://pages.github.com/versions/). To use the gem in GitHub Pages, you need to build locally or use CI (e.g. [travis](https://travis-ci.org/), [github workflow](https://help.github.com/en/actions/configuring-and-managing-workflows/configuring-a-workflow)) and deploy to your `gh-pages` branch.
|
||||
|
||||
### Additions for Unlimited GitHub Pages
|
||||
|
||||
* Here is a GitHub Action named [jekyll-deploy-action](https://github.com/jeffreytse/jekyll-deploy-action) for Jekyll site deployment conveniently. 👍
|
||||
* Here is a [Jekyll site](https://github.com/jeffreytse/jekyll-jeffreytse-blog) using Travis to build and deploy to GitHub Pages for your references.
|
||||
|
||||
## Configuration
|
||||
|
||||
This plugin runs with the following configuration options by default. Alternative settings for these options can be explicitly specified in the configuration file `_config.yml`.
|
||||
|
||||
```yml
|
||||
# Where things are
|
||||
jekyll-spaceship:
|
||||
# default enabled processors
|
||||
processors:
|
||||
- table-processor
|
||||
- mathjax-processor
|
||||
- plantuml-processor
|
||||
- mermaid-processor
|
||||
- polyfill-processor
|
||||
- media-processor
|
||||
- emoji-processor
|
||||
- element-processor
|
||||
mathjax-processor:
|
||||
src:
|
||||
- https://polyfill.io/v3/polyfill.min.js?features=es6
|
||||
- https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
|
||||
config:
|
||||
tex:
|
||||
inlineMath:
|
||||
- ['$','$']
|
||||
- ['\(','\)']
|
||||
svg:
|
||||
fontCache: 'global'
|
||||
plantuml-processor:
|
||||
mode: default # mode value 'pre-fetch' for fetching image at building stage
|
||||
css:
|
||||
class: plantuml
|
||||
syntax:
|
||||
code: 'plantuml!'
|
||||
custom: ['@startuml', '@enduml']
|
||||
src: http://www.plantuml.com/plantuml/svg/
|
||||
mermaid-processor:
|
||||
mode: default # mode value 'pre-fetch' for fetching image at building stage
|
||||
css:
|
||||
class: mermaid
|
||||
syntax:
|
||||
code: 'mermaid!'
|
||||
custom: ['@startmermaid', '@endmermaid']
|
||||
config:
|
||||
theme: default
|
||||
src: https://mermaid.ink/svg/
|
||||
media-processor:
|
||||
default:
|
||||
id: 'media-{id}'
|
||||
class: 'media'
|
||||
width: '100%'
|
||||
height: 350
|
||||
frameborder: 0
|
||||
style: 'max-width: 600px; outline: none;'
|
||||
allow: 'encrypted-media; picture-in-picture'
|
||||
emoji-processor:
|
||||
css:
|
||||
class: emoji
|
||||
src: https://github.githubassets.com/images/icons/emoji/
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
### 1. Table Usage
|
||||
|
||||
**For now, these extended features are provided:**
|
||||
|
||||
- Cells spanning multiple columns
|
||||
- Cells spanning multiple rows
|
||||
- Cells text align separately
|
||||
- Table header not required
|
||||
- Grouped table header rows or data rows
|
||||
* Cells spanning multiple columns
|
||||
* Cells spanning multiple rows
|
||||
* Cells text align separately
|
||||
* Table header not required
|
||||
* Grouped table header rows or data rows
|
||||
|
||||
Noted that GitHub filters out style property, so the example displays with the obsolete align property. But in actual this plugin outputs style property with text-align CSS attribute.
|
||||
|
||||
#### Rowspan and Colspan
|
||||
|
||||
^^ in a cell indicates it should be merged with the cell above.
|
||||
This feature is contributed by [pmccloghrylaing](https://github.com/pmccloghrylaing).
|
||||
|
||||
```markdown
|
||||
| Stage | Direct Products | ATP Yields |
|
||||
| -----------------: | --------------: | ---------: |
|
||||
| Glycolysis | 2 ATP ||
|
||||
| ^^ | 2 NADH | 3--5 ATP |
|
||||
| Pyruvaye oxidation | 2 NADH | 5 ATP |
|
||||
| Citric acid cycle | 2 ATP ||
|
||||
| ^^ | 6 NADH | 15 ATP |
|
||||
| ^^ | 2 FADH | 3 ATP |
|
||||
| ----: | --------------: | ---------: |
|
||||
|Glycolysis | 2 ATP ||
|
||||
|^^ | 2 NADH | 3--5 ATP |
|
||||
|Pyruvaye oxidation | 2 NADH | 5 ATP |
|
||||
|Citric acid cycle | 2 ATP | |
|
||||
|^^ | 6 NADH | 15 ATP |
|
||||
|^^ | 2 FADH | 3 ATP |
|
||||
| 30--32 ATP |||
|
||||
```
|
||||
|
||||
@ -286,13 +111,12 @@ Code above would be parsed as:
|
||||
</table>
|
||||
|
||||
#### Multiline
|
||||
|
||||
A backslash at end to join cell contents with the following lines.
|
||||
This feature is contributed by [Lucas-C](https://github.com/Lucas-C).
|
||||
|
||||
```markdown
|
||||
| : Easy Multiline : |||
|
||||
| :----- | :----- | :------ |
|
||||
|: Easy Multiline :|||
|
||||
|:------ |:------ |:-------- |
|
||||
| Apple | Banana | Orange \
|
||||
| Apple | Banana | Orange \
|
||||
| Apple | Banana | Orange
|
||||
@ -329,7 +153,6 @@ Code above would be parsed as:
|
||||
</table>
|
||||
|
||||
#### Headerless
|
||||
|
||||
Table header can be eliminated.
|
||||
|
||||
```markdown
|
||||
@ -432,19 +255,18 @@ Code above would be parsed as:
|
||||
</table>
|
||||
|
||||
#### Cell Alignment
|
||||
|
||||
Markdown table syntax use colons ":" for forcing column alignment.
|
||||
Therefore, here we also use it for foring cell alignment.
|
||||
|
||||
Table cell can be set alignment separately.
|
||||
|
||||
```markdown
|
||||
| : Fruits \|\| Food : |||
|
||||
| :--------- | :-------- | :-------- |
|
||||
| Apple | : Apple : | Apple \
|
||||
```
|
||||
|: Fruits \|\| Food :|||
|
||||
|:-------- |:-------- |:------------ |
|
||||
| Apple |: Apple :| Apple \
|
||||
| Banana | Banana | Banana \
|
||||
| Orange | Orange | Orange |
|
||||
| : Rowspan is 4 : || How's it? |
|
||||
|: Rowspan is 4 :|| How's it? |
|
||||
|^^ A. Peach || 1. Fine :|
|
||||
|^^ B. Orange ||^^ 2. Bad |
|
||||
|^^ C. Banana || It's OK! |
|
||||
@ -484,138 +306,20 @@ Rowspan is 4
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
#### Cell Markdown
|
||||
|
||||
Sometimes we may need some abundant content (e.g., mathjax, image, video) in Markdown table
|
||||
Therefore, here we also make markown syntax possible inside a cell.
|
||||
|
||||
```markdown
|
||||
| : MathJax \|\| Image : |||
|
||||
| :------------ | :-------- | :----------------------------- |
|
||||
| Apple | : Apple : | Apple \
|
||||
| Banana | Banana | Banana \
|
||||
| Orange | Orange | Orange |
|
||||
| : Rowspan is 4 : || : How's it? : |
|
||||
| ^^ A. Peach || 1. ![example][cell-image] |
|
||||
| ^^ B. Orange || ^^ 2. $I = \int \rho R^{2} dV$ |
|
||||
| ^^ C. Banana || **It's OK!** |
|
||||
|
||||
[cell-image]: https://jekyllrb.com/img/octojekyll.png "An exemplary image"
|
||||
```
|
||||
|
||||
Code above would be parsed as:
|
||||
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th align="center" colspan="3">MathJax || Image
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td align="left">Apple<br>Banana<br>Orange</td>
|
||||
<td align="center">Apple<br>Banana<br>Orange</td>
|
||||
<td align="left">Apple<br>Banana<br>Orange</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="center" rowspan="4" colspan="2">
|
||||
Rowspan is 4
|
||||
<br>A. Peach
|
||||
<br>B. Orange
|
||||
<br>C. Banana
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="center">How's it?</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="left">
|
||||
<ol>
|
||||
<li><img width="100" src="http://latex2png.com/pngs/82b913db54a9f303bed7197d11347d74.png"></img></li>
|
||||
<li><img width="150" src="https://jekyllrb.com/img/octojekyll.png" title="An exemplary image"></img></li>
|
||||
</ol>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="left"><b>It' OK!</b></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
#### Cell Inline Attributes
|
||||
|
||||
This feature is very useful for custom cell such as using inline style. (e.g., background, color, font)
|
||||
The idea and syntax comes from the [Maruku](http://maruku.rubyforge.org/) package.
|
||||
|
||||
[](https://kramdown.gettalong.org/syntax.html#block-ials)
|
||||
|
||||
Following are some examples of attributes definitions (ALDs) and afterwards comes the syntax explanation:
|
||||
|
||||
```markdown
|
||||
{:ref-name: #id .cls1 .cls2}
|
||||
{:second: ref-name #id-of-other title="hallo you"}
|
||||
{:other: ref-name second}
|
||||
```
|
||||
|
||||
An ALD line has the following structure:
|
||||
|
||||
- a left brace, optionally preceded by up to three spaces,
|
||||
- followed by a colon, the id and another colon,
|
||||
- followed by attribute definitions (allowed characters are backslash-escaped closing braces or any character except a not escaped closing brace),
|
||||
- followed by a closing brace and optional spaces until the end of the line.
|
||||
|
||||
If there is more than one ALD with the same reference name, the attribute definitions of all the ALDs are processed like they are defined in one ALD.
|
||||
|
||||
An inline attribute list (IAL) is used to attach attributes to another element.
|
||||
Here are some examples for span IALs:
|
||||
|
||||
```markdown
|
||||
{: #id .cls1 .cls2} <!-- #id <=> id="id", .cls1 .cls2 <=> class="cls1 cls2" -->
|
||||
{: ref-name title="hallo you"}
|
||||
{: ref-name class='.cls3' .cls4}
|
||||
```
|
||||
|
||||
Here is an example for custom table cell with IAL:
|
||||
|
||||
```markdown
|
||||
{:color-style: style="background: black;"}
|
||||
{:color-style: style="color: white;"}
|
||||
{:text-style: style="font-weight: 800; text-decoration: underline;"}
|
||||
|
||||
|: Here's an Inline Attribute Lists example :||||
|
||||
| ------- | ------------------ | -------------------- | ------------------ |
|
||||
|: :|: <div style="color: red;"> < Normal HTML Block > </div> :|||
|
||||
| ^^ | Red {: .cls style="background: orange" } |||
|
||||
| ^^ IALs | Green {: #id style="background: green; color: white" } |||
|
||||
| ^^ | Blue {: style="background: blue; color: white" } |||
|
||||
| ^^ | Black {: color-style text-style } |||
|
||||
```
|
||||
|
||||
Code above would be parsed as:
|
||||
|
||||
<img width="580px" src="https://user-images.githubusercontent.com/9413601/88461592-738afb00-ced7-11ea-9aac-3179023742b0.png" alt="IALs">
|
||||
|
||||
Additionally, [here](https://kramdown.gettalong.org/syntax.html#block-ials) you can learn more details about IALs.
|
||||
|
||||
### 2. MathJax Usage
|
||||
|
||||
[MathJax](http://www.mathjax.org/) is an open-source JavaScript display engine for LaTeX, MathML, and AsciiMath notation that works in all modern browsers.
|
||||
|
||||
Some of the main features of MathJax include:
|
||||
**Some of the main features of MathJax include:**
|
||||
|
||||
- High-quality display of LaTeX, MathML, and AsciiMath notation in HTML pages
|
||||
- Supported in most browsers with no plug-ins, extra fonts, or special
|
||||
* High-quality display of LaTeX, MathML, and AsciiMath notation in HTML pages
|
||||
* Supported in most browsers with no plug-ins, extra fonts, or special
|
||||
setup for the reader
|
||||
- Easy for authors, flexible for publishers, extensible for developers
|
||||
- Supports math accessibility, cut-and-paste interoperability, and other
|
||||
* Easy for authors, flexible for publishers, extensible for developers
|
||||
* Supports math accessibility, cut-and-paste interoperability, and other
|
||||
advanced functionality
|
||||
- Powerful API for integration with other web applications
|
||||
* Powerful API for integration with other web applications
|
||||
|
||||
#### 2.1 Performance optimization
|
||||
|
||||
At building stage, the MathJax engine script will be added by automatically checking whether there is a math expression in the page, this feature can help you improve the page performance on loading speed.
|
||||
|
||||
#### 2.2 How to use?
|
||||
|
||||
Put your math expression within \$...\$
|
||||
|
||||
@ -631,393 +335,38 @@ $ 2^{\frac{n-1}{3}} $
|
||||
$ \int\_a^b f(x)\,dx. $
|
||||
```
|
||||
|
||||
Code above would be parsed as:
|
||||
|
||||
<image alt="MathJax Expression" height="180" src="https://user-images.githubusercontent.com/9413601/82814245-5a5ed180-9ec9-11ea-9d5b-fba303c627ac.png"></image>
|
||||
|
||||
### 3. PlantUML Usage
|
||||
[PlantUML](http://plantuml.sourceforge.net/) is a component that allows to quickly write:
|
||||
* sequence diagram,
|
||||
* use case diagram,
|
||||
* class diagram,
|
||||
* activity diagram,
|
||||
* component diagram,
|
||||
* state diagram
|
||||
* object diagram
|
||||
|
||||
[PlantUML](https://plantuml.com) is a component that allows to quickly write:
|
||||
|
||||
- sequence diagram,
|
||||
- use case diagram,
|
||||
- class diagram,
|
||||
- activity diagram,
|
||||
- component diagram,
|
||||
- state diagram,
|
||||
- object diagram
|
||||
|
||||
There are two ways to create a diagram in your Jekyll blog page:
|
||||
|
||||
````
|
||||
```plantuml!
|
||||
```markdown
|
||||
@startuml
|
||||
Bob -> Alice : hello
|
||||
@enduml
|
||||
```
|
||||
|
||||
or
|
||||
|
||||
````markdown
|
||||
``` plantuml
|
||||
Bob -> Alice : hello world
|
||||
```
|
||||
````
|
||||
|
||||
or
|
||||
|
||||
```markdown
|
||||
@startuml
|
||||
Bob -> Alice : hello
|
||||
@enduml
|
||||
```
|
||||
|
||||
Code above would be parsed as:
|
||||
|
||||
|
||||
|
||||
### 4. Mermaid Usage
|
||||
|
||||
[Mermaid](https://mermaid-js.github.io/) is a Javascript based diagramming and charting tool. It generates diagrams flowcharts and more, using markdown-inspired text for ease and speed.
|
||||
|
||||
It allows to quickly write:
|
||||
|
||||
- flow chart,
|
||||
- pie chart,
|
||||
- sequence diagram,
|
||||
- class diagram,
|
||||
- state diagram,
|
||||
- entity relationship diagram,
|
||||
- user journey,
|
||||
- gantt
|
||||
|
||||
There are two ways to create a diagram in your Jekyll blog page:
|
||||
|
||||
````
|
||||
```mermaid!
|
||||
pie title Pets adopted by volunteers
|
||||
"Dogs" : 386
|
||||
"Cats" : 85
|
||||
"Rats" : 35
|
||||
```
|
||||
````
|
||||
|
||||
or
|
||||
|
||||
```markdown
|
||||
@startmermaid
|
||||
pie title Pets adopted by volunteers
|
||||
"Dogs" : 386
|
||||
"Cats" : 85
|
||||
"Rats" : 35
|
||||
@endmermaid
|
||||
```
|
||||
|
||||
Code above would be parsed as:
|
||||
|
||||
|
||||
|
||||
### 5. Media Usage
|
||||
|
||||
How often did you find yourself googling "**How to embed a video/audio in markdown?**"
|
||||
|
||||
While its not possible to embed a video/audio in markdown, the best and easiest
|
||||
way is to extract a frame from the video/audio. To add videos/audios to your
|
||||
markdown files easier I developped this tool for you, and it will parse the
|
||||
video/audio link inside the image block automatically.
|
||||
|
||||
**For now, these media links parsing are provided:**
|
||||
|
||||
- Youtube
|
||||
- Vimeo
|
||||
- DailyMotion
|
||||
- Spotify
|
||||
- SoundCloud
|
||||
- General Video ( mp4 | avi | ogg | ogv | webm | 3gp | flv | mov ... )
|
||||
- General Audio ( mp3 | wav | ogg | mid | midi | aac | wma ... )
|
||||
|
||||
There are two ways to embed a video/audio in your Jekyll blog page:
|
||||
|
||||
Inline-style:
|
||||
|
||||
```markdown
|
||||
|
||||
```
|
||||
|
||||
Reference-style:
|
||||
|
||||
```markdown
|
||||
![][{reference}]
|
||||
|
||||
[{reference}]: {media-link}
|
||||
```
|
||||
|
||||
For configuring media attributes (e.g, width, height), just adding query string to
|
||||
the link as below:
|
||||
|
||||
```markdown
|
||||
|
||||
|
||||
|
||||
```
|
||||
|
||||
#### Youtube Usage
|
||||
|
||||
```markdown
|
||||
|
||||
|
||||
|
||||
```
|
||||
|
||||
#### Vimeo Usage
|
||||
|
||||
```markdown
|
||||
|
||||
|
||||
|
||||
```
|
||||
|
||||
#### DailyMotion Usage
|
||||
|
||||
```markdown
|
||||
|
||||
|
||||
|
||||
```
|
||||
|
||||
#### Spotify Usage
|
||||
|
||||
```markdown
|
||||
|
||||
```
|
||||
|
||||
<image width="600" src="https://user-images.githubusercontent.com/9413601/89762618-5d11b000-db23-11ea-81db-35cc3682b234.png">
|
||||
|
||||
#### SoundCloud Usage
|
||||
|
||||
```markdown
|
||||
|
||||
```
|
||||
|
||||
<image width="600" src="https://user-images.githubusercontent.com/9413601/89762969-1c666680-db24-11ea-97e3-4340f7fac7ac.png">
|
||||
|
||||
#### General Video Usage
|
||||
|
||||
```markdown
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
```
|
||||
|
||||
#### General Audio Usage
|
||||
|
||||
```markdown
|
||||
|
||||
|
||||
|
||||
```
|
||||
|
||||
<image width="300" src="https://user-images.githubusercontent.com/9413601/89762143-68181080-db22-11ea-8467-e8b2a8a96ae5.png">
|
||||
|
||||
### 6. Hybrid HTML with Markdown
|
||||
|
||||
As markdown is not only a lightweight markup language with plain-text-formatting syntax, but also an easy-to-read and easy-to-write plain text format, so writing a hybrid HTML with markdown is an awesome choice.
|
||||
|
||||
It's easy to write markdown inside HTML:
|
||||
|
||||
```html
|
||||
<script type="text/markdown">
|
||||
# Hybrid HTML with Markdown is a not bad choice ^\_^
|
||||
|
||||
## Table Usage
|
||||
|
||||
| : Fruits \|\| Food : |||
|
||||
| :--------- | :-------- | :-------- |
|
||||
| Apple | : Apple : | Apple \
|
||||
| Banana | Banana | Banana \
|
||||
| Orange | Orange | Orange |
|
||||
| : Rowspan is 4 : || How's it? |
|
||||
|^^ A. Peach || 1. Fine :|
|
||||
|^^ B. Orange ||^^ 2. Bad |
|
||||
|^^ C. Banana || It's OK! |
|
||||
|
||||
## PlantUML Usage
|
||||
|
||||
@startuml
|
||||
Bob -> Alice : hello
|
||||
@enduml
|
||||
|
||||
## Video Usage
|
||||
|
||||
|
||||
</script>
|
||||
```
|
||||
|
||||
### 7. Markdown Polyfill
|
||||
|
||||
It allows us to polyfill features for extending markdown syntax.
|
||||
|
||||
**For now, these polyfill features are provided:**
|
||||
|
||||
- Escape ordered list
|
||||
|
||||
#### 7.1 Escape Ordered List
|
||||
|
||||
A backslash at begin to escape the ordered list.
|
||||
|
||||
```markdown
|
||||
Normal:
|
||||
|
||||
1. List item Apple.
|
||||
3. List item Banana.
|
||||
10. List item Cafe.
|
||||
|
||||
Escaped:
|
||||
|
||||
\1. List item Apple.
|
||||
\3. List item Banana.
|
||||
\10. List item Cafe.
|
||||
```
|
||||
|
||||
Code above would be parsed as:
|
||||
|
||||
```markdown
|
||||
Normal:
|
||||
|
||||
1. List item Apple.
|
||||
2. List item Banana.
|
||||
3. List item Cafe.
|
||||
|
||||
Escaped:
|
||||
|
||||
1. List item Apple.
|
||||
3. List item Banana.
|
||||
10. List item Cafe.
|
||||
```
|
||||
|
||||
### 8. Emoji Usage
|
||||
GitHub-flavored emoji images and names would allow emojifying content such as: it's raining :cat:s and :dog:s!
|
||||
|
||||
Noted that emoji images are served from the GitHub.com CDN, with a base URL of [https://github.githubassets.com](https://github.githubassets.com), which results in emoji image URLs like [https://github.githubassets.com/images/icons/emoji/unicode/1f604.png](https://github.githubassets.com/images/icons/emoji/unicode/1f604.png).
|
||||
|
||||
In any page or post, use emoji as you would normally, e.g.
|
||||
|
||||
```
|
||||
I give this plugin two :+1:!
|
||||
```
|
||||
|
||||
**Code above would be parsed as:**
|
||||
|
||||
I give this plugin two :+1:!
|
||||
|
||||
#### 8.1 Emoji Customizing
|
||||
|
||||
If you'd like to serve emoji images locally, or use a custom emoji source, you can specify so in your `_config.yml` file:
|
||||
|
||||
```yml
|
||||
jekyll-spaceship:
|
||||
emoji-processor:
|
||||
src: "/assets/images/emoji"
|
||||
```
|
||||
|
||||
See the [Gemoji](https://github.com/github/gemoji) documentation for generating image files.
|
||||
|
||||
### 9. Modifying Element Usage
|
||||
|
||||
It allows us to modify elements via `CSS3 selectors`. Through it you can easily
|
||||
modify the attributes of an element tag, replace the children nodes and so on,
|
||||
it's very flexible, but here is example usage for modifying a document:
|
||||
|
||||
```yml
|
||||
# Here is a comprehensive example
|
||||
jekyll-spaceship:
|
||||
element-processor:
|
||||
css:
|
||||
- a: '<h1>Test</h1>' # Replace all `a` tags (String Style)
|
||||
- ['a.link1', 'a.link2']: # Replace all `a.link1`, `a.link2` tags (Hash Style)
|
||||
name: img # Replace element tag name
|
||||
props: # Replace element properties
|
||||
title: Good image # Add a title attribute
|
||||
src: ['(^.*$)', '\0?a=123'] # Add query string to src attribute by regex pattern
|
||||
style: # Add style attribute (Hash Style)
|
||||
color: red
|
||||
font-size: '1.2em'
|
||||
children: # Add children to the element
|
||||
- # First empty for adding after the last child node
|
||||
- "<span>Google</span>" # First child node (String Style)
|
||||
- # Middle empty for wrapping the children nodes
|
||||
- name: span # Second child node (Hash Style)
|
||||
props:
|
||||
prop1: "1" # Custom property1
|
||||
prop2: "2" # Custom property2
|
||||
prop3: "3" # Custom property3
|
||||
children: # Add nested chidren nodes
|
||||
- "<span>Jekyll</span>" # First child node (String Style)
|
||||
- name: span # Second child node (Hash Style)
|
||||
props: # Add attributes to child node (Hash Style)
|
||||
prop1: "a"
|
||||
prop2: "b"
|
||||
prop3: "c"
|
||||
children: "<b>Yap!</b>" # Add children nodes (String Style)
|
||||
- # Last empty for adding before the first child node
|
||||
- a.link: '<a href="//t.com">Link</a>' # Replace all `a.link` tags (String Style)
|
||||
- 'h1#title': # Replace `h1#title` tags (Hash Style)
|
||||
children: I'm a title! # Replace inner html to new text
|
||||
```
|
||||
|
||||
#### Example 1
|
||||
|
||||
Automatically adds a `target="_blank" rel="noopener noreferrer"` attribute to all external links in Jekyll's content.
|
||||
|
||||
```yml
|
||||
jekyll-spaceship:
|
||||
element-processor:
|
||||
css:
|
||||
- a: # Replace all `a` tags
|
||||
props:
|
||||
class: ['(^.*$)', '\0 ext-link'] # Add `ext-link` to class by regex pattern
|
||||
target: _blank # Replace `target` value to `_blank`
|
||||
rel: noopener noreferrer # Replace `rel` value to `noopener noreferrer`
|
||||
```
|
||||
|
||||
#### Example 2
|
||||
|
||||
Automatically adds `loading="lazy"` to `img` and `iframe` tags to natively load lazily.
|
||||
[Browser support](https://caniuse.com/#feat=loading-lazy-attr) is growing. If a browser does not support the `loading` attribute, it will load the resource just like it would normally.
|
||||
|
||||
```yml
|
||||
jekyll-spaceship:
|
||||
element-processor:
|
||||
css:
|
||||
- a: # Replace all `a` tags
|
||||
props: #
|
||||
loading: lazy # Replace `loading` value to `lazy`
|
||||
```
|
||||
|
||||
In case you want to prevent loading some images/iframes lazily, add
|
||||
`loading="eager"` to their tags. This might be useful to prevent flickering of
|
||||
images during navigation (e.g. the site's logo).
|
||||
|
||||
See the following examples to prevent lazy loading.
|
||||
|
||||
```yml
|
||||
jekyll-spaceship:
|
||||
element-processor:
|
||||
css:
|
||||
- a: # Replace all `a` tags
|
||||
props: #
|
||||
loading: eager # Replace `loading` value to `eager`
|
||||
```
|
||||
|
||||
There are three options when using this method to lazy load images. Here are the supported values for the loading attribute:
|
||||
|
||||
- auto: Default lazy-loading behavior of the browser, which is the same as not including the attribute.
|
||||
- lazy: Defer loading of the resource until it reaches a calculated distance from the viewport.
|
||||
- eager: Load the resource immediately, regardless of where it’s located on the page.
|
||||
|
||||
|
||||
## Credits
|
||||
|
||||
- [Jekyll](https://github.com/jekyll/jekyll) - A blog-aware static site generator in Ruby.
|
||||
- [MultiMarkdown](https://fletcher.github.io/MultiMarkdown-6) - Lightweight markup processor to produce HTML, LaTeX, and more.
|
||||
- [markdown-it-multimd-table](https://github.com/RedBug312/markdown-it-multimd-table) - Multimarkdown table syntax plugin for markdown-it markdown parser.
|
||||
- [jmoji](https://github.com/jekyll/jemoji) - GitHub-flavored emoji plugin for Jekyll.
|
||||
- [jekyll-target-blank](https://github.com/keithmifsud/jekyll-target-blank) - Automatically opens external links in a new browser for Jekyll Pages, Posts and Docs.
|
||||
- [jekyll-loading-lazy](https://github.com/gildesmarais/jekyll-loading-lazy) - Automatically adds loading="lazy" to img and iframe tags to natively load lazily.
|
||||
- [mermaid](https://github.com/mermaid-js/mermaid) - Generation of diagram and flowchart from text in a similar manner as markdown.
|
||||
|
||||
## Contributing
|
||||
|
||||
@ -1026,5 +375,4 @@ Issues and Pull Requests are greatly appreciated. If you've never contributed to
|
||||
You can start by [opening an issue](https://github.com/jeffreytse/jekyll-spaceship/issues/new) describing the problem that you're looking to resolve and we'll go from there.
|
||||
|
||||
## License
|
||||
|
||||
This software is licensed under the [MIT license](https://opensource.org/licenses/mit-license.php) © JeffreyTse.
|
||||
|
||||
8
Rakefile
8
Rakefile
@ -1,8 +0,0 @@
|
||||
# frozen_string_literal: true
|
||||
|
||||
require "bundler/gem_tasks"
|
||||
require "rspec/core/rake_task"
|
||||
|
||||
RSpec::Core::RakeTask.new(:spec)
|
||||
|
||||
task :default => :spec
|
||||
@ -9,7 +9,7 @@ Gem::Specification.new do |spec|
|
||||
spec.version = Jekyll::Spaceship::VERSION
|
||||
spec.authors = ["jeffreytse"]
|
||||
spec.email = ["jeffreytse.mail@gmail.com"]
|
||||
spec.summary = "A Jekyll plugin to provide powerful supports for table, mathjax, plantuml, mermaid, emoji, video, audio, youtube, vimeo, dailymotion, spotify, soundcloud, etc."
|
||||
spec.summary = "A Jekyll plugin to provide powerful supports for table, mathjax, plantuml, etc."
|
||||
spec.homepage = "https://github.com/jeffreytse/jekyll-spaceship"
|
||||
spec.license = "MIT"
|
||||
|
||||
@ -18,12 +18,10 @@ Gem::Specification.new do |spec|
|
||||
|
||||
spec.required_ruby_version = ">= 2.3.0"
|
||||
|
||||
spec.add_dependency "jekyll", ">= 3.6", "< 5.0"
|
||||
spec.add_dependency "nokogiri", "~> 1.6"
|
||||
spec.add_dependency "gemoji", "~> 3.0"
|
||||
spec.add_dependency "rainbow", "~> 3.0"
|
||||
spec.add_runtime_dependency "nokogiri", "~> 1.6"
|
||||
|
||||
spec.add_development_dependency "bundler"
|
||||
spec.add_development_dependency "jekyll", "~> 3.7"
|
||||
spec.add_development_dependency "bundler", "~> 1.10"
|
||||
spec.add_development_dependency "rake", "~> 12.0"
|
||||
spec.add_development_dependency "rspec", "~> 3.0"
|
||||
end
|
||||
|
||||
@ -1,12 +1,12 @@
|
||||
# frozen_string_literal: true
|
||||
|
||||
require 'jekyll-spaceship/cores/logger'
|
||||
require 'jekyll-spaceship/cores/config'
|
||||
require 'jekyll-spaceship/cores/manager'
|
||||
require 'jekyll-spaceship/cores/processor'
|
||||
require 'jekyll-spaceship/cores/register'
|
||||
|
||||
module Jekyll::Spaceship
|
||||
Logger.display_info
|
||||
Config.load_config
|
||||
Register.use 'table-processor'
|
||||
Register.use 'mathjax-processor'
|
||||
Register.use 'plantuml-processor'
|
||||
end
|
||||
|
||||
@ -1,61 +0,0 @@
|
||||
# frozen_string_literal: true
|
||||
|
||||
module Jekyll::Spaceship
|
||||
class Config
|
||||
CONFIG_NAME = 'jekyll-spaceship'
|
||||
DEFAULT_CONFIG = {
|
||||
'processors' => [
|
||||
'table-processor',
|
||||
'mathjax-processor',
|
||||
'plantuml-processor',
|
||||
'mermaid-processor',
|
||||
'polyfill-processor',
|
||||
'media-processor',
|
||||
'emoji-processor',
|
||||
'element-processor'
|
||||
]
|
||||
}
|
||||
|
||||
@@store = {}
|
||||
|
||||
def self.deep_merge(first, second)
|
||||
merger = proc do |_, f, s|
|
||||
if Hash === f && Hash === s
|
||||
f.merge(s, &merger)
|
||||
elsif Array === f && Array === s
|
||||
s || f
|
||||
else
|
||||
[:undefined, nil, :nil].include?(s) ? f : s
|
||||
end
|
||||
end
|
||||
first.merge(second.to_h, &merger)
|
||||
end
|
||||
|
||||
def self.store(section, default)
|
||||
return @@store[section] if default.nil?
|
||||
@@store[section] = deep_merge(default, @@store[section])
|
||||
end
|
||||
|
||||
def self.load(config = {})
|
||||
config = deep_merge(
|
||||
{ CONFIG_NAME => DEFAULT_CONFIG },
|
||||
config
|
||||
)[CONFIG_NAME]
|
||||
@@store = config
|
||||
self.use_processors(config)
|
||||
end
|
||||
|
||||
def self.use_processors(config)
|
||||
config['processors'].each do |processor|
|
||||
Register.use processor
|
||||
end
|
||||
end
|
||||
|
||||
def self.load_config
|
||||
# post load site config for `group :jekyll_plugin`
|
||||
Jekyll::Hooks.register :site, :after_init do |site|
|
||||
self.load(site.config)
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -1,36 +1,21 @@
|
||||
# frozen_string_literal: true
|
||||
|
||||
require 'jekyll-spaceship/version'
|
||||
require 'rainbow/refinement'
|
||||
|
||||
using Rainbow
|
||||
|
||||
module Jekyll::Spaceship
|
||||
class Logger
|
||||
def initialize(namespace)
|
||||
@namespace = namespace
|
||||
end
|
||||
|
||||
def self.display_info
|
||||
self.log "🚀 Jekyll-Spaceship #{Jekyll::Spaceship::VERSION}"
|
||||
self.log '🎉 A Jekyll plugin to provide powerful supports.'
|
||||
self.log '👉 ' + 'https://github.com/jeffreytse/jekyll-spaceship'.underline
|
||||
self.log "Jekyll-Spaceship #{Jekyll::Spaceship::VERSION}"
|
||||
self.log "A Jekyll plugin to provide powerful supports."
|
||||
self.log "https://github.com/jeffreytse/jekyll-spaceship"
|
||||
end
|
||||
|
||||
def self.log(content)
|
||||
self.output 'Jekyll Spaceship', content.bright
|
||||
self.output "Jekyll Spaceship", content
|
||||
end
|
||||
|
||||
def self.output(title, content)
|
||||
puts "#{title.rjust(18)}: #{content}"
|
||||
end
|
||||
|
||||
def log(content)
|
||||
if @namespace.nil?
|
||||
self.class.log content
|
||||
else
|
||||
self.class.log "[#{@namespace}] #{content}"
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
@ -1,119 +0,0 @@
|
||||
# frozen_string_literal: true
|
||||
|
||||
require 'nokogiri'
|
||||
require __dir__ + '/type'
|
||||
|
||||
module Jekyll::Spaceship
|
||||
class Manager
|
||||
@@_hooks = {}
|
||||
@@_processors = []
|
||||
|
||||
def self.add(processor)
|
||||
# register for listening event
|
||||
processor.registers.each do |_register|
|
||||
container = _register.first
|
||||
events = _register.last.uniq
|
||||
events = events.select do |event|
|
||||
next true if event.match(/^post/)
|
||||
next events.index(event.to_s.gsub(/^pre/, 'post').to_sym).nil?
|
||||
end
|
||||
events.each do |event|
|
||||
self.hook container, event
|
||||
end
|
||||
end
|
||||
@@_processors.push(processor)
|
||||
@@_processors = @@_processors.sort { |a, b| b.priority <=> a.priority }
|
||||
end
|
||||
|
||||
def self.hook(container, event, &block)
|
||||
return if not is_hooked? container, event
|
||||
|
||||
handler = ->(page) {
|
||||
self.dispatch page, container, event
|
||||
block.call if block
|
||||
}
|
||||
|
||||
if event.to_s.start_with?('after')
|
||||
Jekyll::Hooks.register container, event do |page|
|
||||
handler.call page
|
||||
end
|
||||
elsif event.to_s.start_with?('post')
|
||||
Jekyll::Hooks.register container, event do |page|
|
||||
handler.call page
|
||||
end
|
||||
# auto add pre-event
|
||||
self.hook container, event.to_s.sub('post', 'pre').to_sym
|
||||
elsif event.to_s.start_with?('pre')
|
||||
Jekyll::Hooks.register container, event do |page|
|
||||
handler.call page
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
def self.is_hooked?(container, event)
|
||||
hook_name = "#{container}_#{event}".to_sym
|
||||
return false if @@_hooks.has_key? hook_name
|
||||
@@_hooks[hook_name] = true
|
||||
end
|
||||
|
||||
def self.dispatch(page, container, event)
|
||||
@@_processors.each do |processor|
|
||||
processor.dispatch page, container, event
|
||||
end
|
||||
if event.to_s.start_with?('post') and Type.html? output_ext(page)
|
||||
self.dispatch_html_block(page)
|
||||
end
|
||||
@@_processors.each do |processor|
|
||||
processor.on_handled if processor.handled
|
||||
end
|
||||
end
|
||||
|
||||
def self.ext(page)
|
||||
ext = page.path.match(/\.[^.]+$/)
|
||||
ext.to_s.rstrip
|
||||
end
|
||||
|
||||
def self.output_ext(page)
|
||||
page.url_placeholders[:output_ext]
|
||||
end
|
||||
|
||||
def self.converter(page, name)
|
||||
page.site.converters.each do |converter|
|
||||
class_name = converter.class.to_s.downcase
|
||||
return converter if class_name.end_with?(name.downcase)
|
||||
end
|
||||
end
|
||||
|
||||
def self.dispatch_html_block(page)
|
||||
doc = Nokogiri::HTML(page.output)
|
||||
doc.css('script').each do |node|
|
||||
type = Type.html_block_type node['type']
|
||||
content = node.content
|
||||
next if type.nil?
|
||||
|
||||
# dispatch to on_handle_html_block
|
||||
@@_processors.each do |processor|
|
||||
next unless processor.process?
|
||||
content = processor.on_handle_html_block content, type
|
||||
# dispatch to type handlers
|
||||
method = "on_handle_#{type}"
|
||||
next unless processor.respond_to? method
|
||||
content = processor.pre_exclude content
|
||||
content = processor.send method, content
|
||||
content = processor.after_exclude content
|
||||
end
|
||||
|
||||
cvter = self.converter page, type
|
||||
content = cvter.convert content unless cvter.nil?
|
||||
|
||||
# dispatch to on_handle_html
|
||||
@@_processors.each do |processor|
|
||||
next unless processor.process?
|
||||
content = processor.on_handle_html content
|
||||
end
|
||||
node.replace Nokogiri::HTML.fragment content
|
||||
end
|
||||
page.output = Processor.escape_html doc.to_html
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -2,234 +2,67 @@
|
||||
|
||||
module Jekyll::Spaceship
|
||||
class Processor
|
||||
DEFAULT_PRIORITY = 20
|
||||
|
||||
PRIORITY_MAP = {
|
||||
:lowest => 0,
|
||||
:low => 10,
|
||||
:normal => 20,
|
||||
:high => 30,
|
||||
:highest => 40,
|
||||
}.freeze
|
||||
|
||||
@@_registers = []
|
||||
@@_exclusions = []
|
||||
@@_priority = nil
|
||||
|
||||
attr_reader :page
|
||||
attr_reader :logger
|
||||
attr_reader :config
|
||||
attr_reader :priority
|
||||
attr_reader :registers
|
||||
attr_reader :exclusions
|
||||
attr_accessor :handled
|
||||
|
||||
def name
|
||||
self.class.name.split('::').last
|
||||
end
|
||||
|
||||
def filename
|
||||
self.name
|
||||
.gsub(/([A-Z]+)([A-Z][a-z])/,'\1-\2')
|
||||
.gsub(/([a-z\d])([A-Z])/,'\1-\2')
|
||||
.tr("_", "-")
|
||||
.downcase
|
||||
end
|
||||
|
||||
def initialize()
|
||||
self.initialize_priority
|
||||
self.initialize_register
|
||||
self.initialize_exclusions
|
||||
@logger = Logger.new(self.name)
|
||||
@config = Config.store(self.filename, self.class.config)
|
||||
@handled_files = {}
|
||||
@@_registers.each do |_register|
|
||||
container = _register.first
|
||||
events = _register.last.uniq
|
||||
events = events.select do |event|
|
||||
next true if event.match?(/^post/)
|
||||
next !events.any?(event.to_s.gsub(/^pre/, 'post').to_sym)
|
||||
end
|
||||
|
||||
def initialize_priority
|
||||
@priority = @@_priority
|
||||
unless @priority.nil? or @priority.is_a? Numeric
|
||||
@priority = PRIORITY_MAP[@priority.to_sym]
|
||||
events.each do |event|
|
||||
register container, event
|
||||
end
|
||||
@priority = DEFAULT_PRIORITY if @priority.nil?
|
||||
@@_priority = nil
|
||||
end
|
||||
|
||||
def initialize_register
|
||||
if @@_registers.size.zero?
|
||||
self.class.register :pages, :pre_render, :post_render
|
||||
self.class.register :documents, :pre_render, :post_render
|
||||
end
|
||||
@registers = Array.new @@_registers
|
||||
@@_registers.clear
|
||||
end
|
||||
|
||||
def initialize_exclusions
|
||||
if @@_exclusions.size.zero?
|
||||
self.class.exclude :code, :math, :liquid_filter
|
||||
end
|
||||
@exclusions = @@_exclusions.uniq
|
||||
@@_exclusions.clear
|
||||
end
|
||||
|
||||
def self.priority(value)
|
||||
@@_priority = value.to_sym
|
||||
def content_tag(post)
|
||||
# pre-handle content
|
||||
content_tag = "<content_tag id=\"#{post.url}\" />"
|
||||
end
|
||||
|
||||
def self.register(container, *events)
|
||||
@@_registers << [container, events]
|
||||
end
|
||||
|
||||
def self.exclude(*types)
|
||||
@@_exclusions = types
|
||||
end
|
||||
|
||||
def self.config
|
||||
end
|
||||
|
||||
def process?
|
||||
Type.html?(output_ext) or Type.markdown?(ext)
|
||||
end
|
||||
|
||||
def ext
|
||||
Manager.ext @page
|
||||
end
|
||||
|
||||
def output_ext
|
||||
Manager.output_ext @page
|
||||
end
|
||||
|
||||
def converter(name)
|
||||
Manager.converter @page, name
|
||||
end
|
||||
|
||||
def dispatch(page, container, event)
|
||||
@page = page
|
||||
@handled = false
|
||||
return unless self.process?
|
||||
def register(container, event, &block)
|
||||
# define handle proc
|
||||
handle = ->(post) {
|
||||
method = "on_#{container}_#{event}"
|
||||
self.send method, @page if self.respond_to? method
|
||||
method = ''
|
||||
if event.to_s.start_with?('pre')
|
||||
if Type.markdown? ext
|
||||
method = 'on_handle_markdown'
|
||||
end
|
||||
if self.respond_to? method
|
||||
@page.content = self.pre_exclude @page.content
|
||||
@page.content = self.send method, @page.content
|
||||
@page.content = self.post_exclude @page.content
|
||||
end
|
||||
else
|
||||
if Type.html? output_ext
|
||||
method = 'on_handle_html'
|
||||
elsif Type.css? output_ext
|
||||
method = 'on_handle_css'
|
||||
end
|
||||
if self.respond_to? method
|
||||
@page.output = self.send method, @page.output
|
||||
if Type.html? output_ext
|
||||
@page.output = self.class.escape_html(@page.output)
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
def on_handle_html_block(content, type)
|
||||
# default handle method
|
||||
content
|
||||
end
|
||||
|
||||
def on_handle_html(content)
|
||||
# default handle method
|
||||
content
|
||||
end
|
||||
|
||||
def on_handled
|
||||
source = page.site.source
|
||||
file = page.path.sub(/^#{source}\//, '')
|
||||
return if @handled_files.has_key? file
|
||||
@handled_files[file] = true
|
||||
logger.log file
|
||||
end
|
||||
|
||||
def exclusion_regexs()
|
||||
regexs = []
|
||||
@exclusions.each do |type|
|
||||
regex = nil
|
||||
if type == :code
|
||||
regex = /(((?<!\\)`+)\s*(\w*)((?:.|\n)*?)\2)/
|
||||
elsif type == :math
|
||||
regex = /(((?<!\\)\${1,2})[^\n]*?\1)/
|
||||
elsif type == :liquid_filter
|
||||
regex = /((?<!\\)((\{\{[^\n]*?\}\})|(\{%[^\n]*?%\})))/
|
||||
end
|
||||
regexs.push regex unless regex.nil?
|
||||
end
|
||||
regexs
|
||||
end
|
||||
|
||||
def pre_exclude(content, regexs = self.exclusion_regexs())
|
||||
@exclusion_store = []
|
||||
regexs.each do |regex|
|
||||
content.scan(regex) do |match_data|
|
||||
match = match_data[0]
|
||||
id = @exclusion_store.size
|
||||
content = content.sub(match, "<!JEKYLL@#{object_id}@#{id}>")
|
||||
@exclusion_store.push match
|
||||
end
|
||||
end
|
||||
content
|
||||
end
|
||||
|
||||
def post_exclude(content)
|
||||
while @exclusion_store.size > 0
|
||||
match = @exclusion_store.pop
|
||||
id = @exclusion_store.size
|
||||
content = content.sub("<!JEKYLL@#{object_id}@#{id}>", match)
|
||||
end
|
||||
@exclusion_store = []
|
||||
content
|
||||
end
|
||||
|
||||
def self.escape_html(content)
|
||||
# escape link
|
||||
content.scan(/((https?:)?\/\/\S+\?[a-zA-Z0-9%\-_=\.&;]+)/) do |result|
|
||||
result = result[0]
|
||||
link = result.gsub('&', '&')
|
||||
content = content.gsub(result, link)
|
||||
end
|
||||
content
|
||||
end
|
||||
|
||||
def self.fetch_img_data(url)
|
||||
begin
|
||||
res = Net::HTTP.get_response URI(url)
|
||||
raise res.body unless res.is_a?(Net::HTTPSuccess)
|
||||
content_type = res.header['Content-Type']
|
||||
raise 'Unknown content type!' if content_type.nil?
|
||||
content_body = res.body.force_encoding('UTF-8')
|
||||
return {
|
||||
'type' => content_type,
|
||||
'body' => content_body
|
||||
self.send method, post if self.respond_to? method
|
||||
block.call(post) if block
|
||||
}
|
||||
rescue StandardError => msg
|
||||
logger.log msg
|
||||
|
||||
if event.to_s.start_with?("after")
|
||||
Jekyll::Hooks.register container, event do |post|
|
||||
handle.call post
|
||||
end
|
||||
elsif event.to_s.start_with?("post")
|
||||
Jekyll::Hooks.register container, event do |post|
|
||||
# remove content tags
|
||||
tag = self.content_tag(post)
|
||||
post.content = post.content.gsub(tag, "")
|
||||
|
||||
handle.call post
|
||||
|
||||
# replace output content
|
||||
post.output = post.output.gsub(/#{tag}.*#{tag}/m, post.content)
|
||||
end
|
||||
|
||||
def self.make_img_tag(data)
|
||||
css_class = data['class']
|
||||
type = data['type']
|
||||
body = data['body']
|
||||
if type == 'url'
|
||||
"<img class=\"#{css_class}\" src=\"#{body}\">"
|
||||
elsif type.include?('svg')
|
||||
body.gsub(/\<\?xml.*?\?>/, '')
|
||||
.gsub(/<!--[^\0]*?-->/, '')
|
||||
.sub(/<svg /, "<svg class=\"#{css_class}\" ")
|
||||
else
|
||||
body = Base64.encode64(body)
|
||||
body = "data:#{type};base64, #{body}"
|
||||
"<img class=\"#{css_class}\" src=\"#{body}\">"
|
||||
# auto add pre-event
|
||||
register container, event.to_s.sub("post", "pre").to_sym
|
||||
elsif event.to_s.start_with?("pre")
|
||||
Jekyll::Hooks.register container, event do |post|
|
||||
# wrap post content with tags
|
||||
tag = self.content_tag(post)
|
||||
|
||||
handle.call post
|
||||
|
||||
post.content = "#{tag}\n#{post.content}\n#{tag}"
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
@ -5,10 +5,10 @@ module Jekyll::Spaceship
|
||||
def self.walk(start, &block)
|
||||
Dir.foreach start do |x|
|
||||
path = File.join(start, x)
|
||||
if x == '.' or x == '..'
|
||||
if x == "." or x == ".."
|
||||
next
|
||||
elsif File.directory?(path)
|
||||
block.call(path + '/')
|
||||
block.call(path + "/")
|
||||
walk path
|
||||
else
|
||||
block.call(path)
|
||||
@ -18,23 +18,27 @@ module Jekyll::Spaceship
|
||||
|
||||
def self.use(name)
|
||||
name = name.to_s.gsub(/-/, '').downcase
|
||||
name += 'processor' unless name.match(/processor$/)
|
||||
name += 'processor' unless name.match?(/processor$/)
|
||||
|
||||
self.walk(File.join(File.dirname(__FILE__), '/../processors')) do |path|
|
||||
filename = File.basename(path, '.rb')
|
||||
next if filename.gsub(/-/, '').downcase != name
|
||||
|
||||
Logger.log "🗂 use #{filename}"
|
||||
Logger.log "use #{filename}"
|
||||
|
||||
require path
|
||||
|
||||
constants = Jekyll::Spaceship.constants.select do |c|
|
||||
c.downcase.to_s == name
|
||||
end
|
||||
|
||||
next if constants.first.nil?
|
||||
|
||||
_class = Jekyll::Spaceship.const_get(constants.first)
|
||||
|
||||
next unless _class.is_a? Class
|
||||
|
||||
Manager.add _class.new
|
||||
_class.new
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
@ -1,41 +0,0 @@
|
||||
# frozen_string_literal: true
|
||||
|
||||
module Jekyll::Spaceship
|
||||
class Type
|
||||
HTML_EXTENSIONS = %w(
|
||||
.html
|
||||
.xhtml
|
||||
.htm
|
||||
).freeze
|
||||
|
||||
CSS_EXTENSIONS = %w(
|
||||
.css
|
||||
.scss
|
||||
).freeze
|
||||
|
||||
MD_EXTENSIONS = %w(
|
||||
.md
|
||||
.markdown
|
||||
).freeze
|
||||
|
||||
HTML_BLOCK_TYPE_MAP = {
|
||||
'text/markdown' => 'markdown',
|
||||
}.freeze
|
||||
|
||||
def self.html?(_ext)
|
||||
HTML_EXTENSIONS.include?(_ext)
|
||||
end
|
||||
|
||||
def self.css?(_ext)
|
||||
CSS_EXTENSIONS.include?(_ext)
|
||||
end
|
||||
|
||||
def self.markdown?(_ext)
|
||||
MD_EXTENSIONS.include?(_ext)
|
||||
end
|
||||
|
||||
def self.html_block_type(type)
|
||||
HTML_BLOCK_TYPE_MAP[type]
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -1,170 +0,0 @@
|
||||
# frozen_string_literal: true
|
||||
|
||||
require 'nokogiri'
|
||||
|
||||
module Jekyll::Spaceship
|
||||
class ElementProcessor < Processor
|
||||
priority :lowest
|
||||
|
||||
def self.config
|
||||
{ 'css' => [] }
|
||||
end
|
||||
|
||||
def on_handle_html(content)
|
||||
return content if config['css'].size.zero?
|
||||
|
||||
# use nokogiri to parse html content
|
||||
doc = Nokogiri::HTML(content)
|
||||
|
||||
# handle each css pattern
|
||||
config['css'].each do |data|
|
||||
data.each do |key, val|
|
||||
key = [key] if key.kind_of? String
|
||||
key.each do |pattern|
|
||||
nodes = doc.css(pattern)
|
||||
nodes.each do |element|
|
||||
handle_css_pattern({
|
||||
:doc => doc,
|
||||
:element => element,
|
||||
:data => val
|
||||
})
|
||||
end
|
||||
self.handled = true
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
doc.to_html
|
||||
end
|
||||
|
||||
def handle_css_pattern(data)
|
||||
doc = data[:doc]
|
||||
element = data[:element]
|
||||
data = data[:data]
|
||||
|
||||
if data.kind_of? String
|
||||
element.replace Nokogiri::HTML.fragment(data)
|
||||
elsif data.kind_of? Hash
|
||||
handle_hash_element({
|
||||
:doc => doc,
|
||||
:element => element,
|
||||
:data => data,
|
||||
})
|
||||
end
|
||||
end
|
||||
|
||||
def create_children(data)
|
||||
doc = data[:doc]
|
||||
data = data[:data]
|
||||
root = Nokogiri::HTML.fragment("")
|
||||
|
||||
data = [data] unless data.kind_of? Array
|
||||
data.each do |child_data|
|
||||
node = self.create_element({
|
||||
:doc => doc,
|
||||
:data => child_data
|
||||
})
|
||||
next if node.nil?
|
||||
unless child_data['children'].nil?
|
||||
node.children = self.create_children({
|
||||
:doc => doc,
|
||||
:data => child_data['children']
|
||||
})
|
||||
end
|
||||
root.add_child node
|
||||
end
|
||||
root.children
|
||||
end
|
||||
|
||||
def handle_hash_element(data)
|
||||
doc = data[:doc]
|
||||
element = data[:element]
|
||||
data = data[:data]
|
||||
|
||||
# set name
|
||||
element.name = data['name'] unless data['name'].nil?
|
||||
|
||||
# set props
|
||||
data['props']&.each do |prop, val|
|
||||
next element.remove_attribute if val.nil?
|
||||
if val.kind_of? Array
|
||||
next if val.size != 2
|
||||
v = element[prop]
|
||||
v = '' if v.nil?
|
||||
val = v.sub(/#{val[0]}/, val[1])
|
||||
elsif val.kind_of? Hash
|
||||
result = []
|
||||
val.each { |k, v| result.push "#{k}: #{v}" }
|
||||
val = result.join(";")
|
||||
end
|
||||
element.set_attribute(prop, val)
|
||||
end
|
||||
|
||||
# processing children
|
||||
return unless data.has_key?('children')
|
||||
return element.inner_html = "" if data['children'].nil?
|
||||
children = self.create_children({
|
||||
:doc => doc,
|
||||
:data => data['children']
|
||||
})
|
||||
|
||||
handle_element_placement({
|
||||
:data => data,
|
||||
:element => element,
|
||||
:children => children,
|
||||
})
|
||||
end
|
||||
|
||||
def create_element(data)
|
||||
doc = data[:doc]
|
||||
data = data[:data]
|
||||
|
||||
return if data.nil?
|
||||
return Nokogiri::HTML.fragment(data) if data.kind_of? String
|
||||
return if data['name'].nil?
|
||||
|
||||
# create node
|
||||
node = doc.create_element(data['name'])
|
||||
|
||||
# set props
|
||||
data['props']&.each do |prop, val|
|
||||
if val.kind_of? Hash
|
||||
result = []
|
||||
val.each { |k, v| result.push "#{k}: #{v}" }
|
||||
val = result.join(";")
|
||||
end
|
||||
node.set_attribute(prop, val)
|
||||
end
|
||||
node
|
||||
end
|
||||
|
||||
def handle_element_placement(data)
|
||||
element = data[:element]
|
||||
children = data[:children]
|
||||
data = data[:data]
|
||||
|
||||
# replace whole inner html
|
||||
unless data['children'].kind_of? Array
|
||||
return element.inner_html = children
|
||||
end
|
||||
|
||||
if element.children.size.zero?
|
||||
return element.inner_html = children
|
||||
end
|
||||
|
||||
index = data['children'].index(nil)
|
||||
rindex = data['children'].rindex { |item| !item.nil? }
|
||||
|
||||
if index.nil?
|
||||
element.inner_html = children
|
||||
elsif index == 0 # insert to the end of children
|
||||
element.children.last.after(children)
|
||||
elsif index == rindex + 1 # insert to the begin of children
|
||||
element.children.first.before children
|
||||
else # wrap the children
|
||||
element.children.first.before children[0..index]
|
||||
element.children.last.after children[index..children.size]
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -1,46 +0,0 @@
|
||||
# frozen_string_literal: true
|
||||
|
||||
require 'net/http'
|
||||
require 'json'
|
||||
require 'gemoji'
|
||||
|
||||
module Jekyll::Spaceship
|
||||
class EmojiProcessor < Processor
|
||||
def self.config
|
||||
{
|
||||
'css' => {
|
||||
'class' => 'emoji'
|
||||
},
|
||||
'src' => 'https://github.githubassets.com/images/icons/emoji/'
|
||||
}
|
||||
end
|
||||
|
||||
def on_handle_html(content)
|
||||
# handle emoji markup
|
||||
content.scan(/:([\w\d+-]+):/) do |match|
|
||||
emoji = Emoji.find_by_alias match[0]
|
||||
next if emoji.nil?
|
||||
self.handled = true
|
||||
|
||||
# escape plus sign
|
||||
emoji_name = emoji.name.gsub('+', '\\\+')
|
||||
css_class = self.config['css']['class']
|
||||
|
||||
content = content.gsub(
|
||||
/(?<!\=")\s*:#{emoji_name}:\s*(?!"\s)/,
|
||||
"<img class=\"#{css_class}\""\
|
||||
" title=\":#{emoji.name}:\""\
|
||||
" alt=\":#{emoji.name}:\""\
|
||||
" raw=\"#{emoji.raw}\""\
|
||||
" src=\"#{config['src']}#{emoji.image_filename}\""\
|
||||
" style=\"vertical-align: middle; display: inline;"\
|
||||
" max-width: 1em; visibility: hidden;\""\
|
||||
" onload=\"this.style.visibility='visible'\""\
|
||||
" onerror=\"this.replaceWith(this.getAttribute('raw'))\">"\
|
||||
"</img>"
|
||||
)
|
||||
end
|
||||
content
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -1,66 +1,20 @@
|
||||
# frozen_string_literal: true
|
||||
|
||||
require "nokogiri"
|
||||
require 'nokogiri'
|
||||
|
||||
module Jekyll::Spaceship
|
||||
class MathjaxProcessor < Processor
|
||||
def self.config
|
||||
{
|
||||
'src' => [
|
||||
'https://polyfill.io/v3/polyfill.min.js?features=es6',
|
||||
'https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js',
|
||||
],
|
||||
'config' => {
|
||||
'tex' => { 'inlineMath' => [['$','$'], ['\\(','\\)']] },
|
||||
'svg': { 'fontCache': 'global' }
|
||||
}
|
||||
}
|
||||
end
|
||||
register :posts, :post_render
|
||||
|
||||
def process?
|
||||
return true if Type.html?(output_ext)
|
||||
end
|
||||
|
||||
def on_handle_html(content)
|
||||
def on_posts_post_render(post)
|
||||
# use nokogiri to parse html
|
||||
doc = Nokogiri::HTML(content)
|
||||
doc = Nokogiri::HTML(post.output)
|
||||
|
||||
head = doc.at('head')
|
||||
return content if head.nil?
|
||||
return content if not self.has_mathjax_expression? doc
|
||||
params = "config=TeX-AMS-MML_HTMLorMML"
|
||||
src = "//cdn.mathjax.org/mathjax/latest/MathJax.js?#{params}"
|
||||
doc.at('head').add_child("<script src=\"#{src}\"></script>")
|
||||
|
||||
self.handled = true
|
||||
|
||||
# add mathjax config
|
||||
cfg = config['config'].to_json
|
||||
head.add_child("<script>MathJax=#{cfg}</script>")
|
||||
|
||||
# add mathjax dependencies
|
||||
config['src'] = [config['src']] if config['src'].is_a? String
|
||||
config['src'].each do |src|
|
||||
head.add_child("<script src=\"#{src}\"></script>")
|
||||
end
|
||||
|
||||
doc.to_html
|
||||
end
|
||||
|
||||
def has_mathjax_expression?(doc)
|
||||
doc.css('*').each do |node|
|
||||
if node.content.match(/(?<!\\)\$.+(?<!\\)\$/)
|
||||
return true
|
||||
end
|
||||
if node.content.match(/(?<!\\)\\\(.+(?<!\\)\\\)/)
|
||||
return true
|
||||
end
|
||||
end
|
||||
|
||||
doc.css('script').each do |node|
|
||||
type = node['type']
|
||||
if type and type.match(/math\/tex/)
|
||||
return true
|
||||
end
|
||||
end
|
||||
false
|
||||
post.output = doc.to_s
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
@ -1,234 +0,0 @@
|
||||
# frozen_string_literal: true
|
||||
|
||||
require 'uri'
|
||||
|
||||
module Jekyll::Spaceship
|
||||
class MediaProcessor < Processor
|
||||
def self.config
|
||||
{
|
||||
'default' => {
|
||||
'id' => 'media-{id}',
|
||||
'class' => 'media',
|
||||
'width' => '100%',
|
||||
'height' => 350,
|
||||
'frameborder' => 0,
|
||||
'style' => 'max-width: 600px;outline: none',
|
||||
'allow' => 'encrypted-media; picture-in-picture'
|
||||
}
|
||||
}
|
||||
end
|
||||
|
||||
def on_handle_markdown(content)
|
||||
content = handle_normal_audio(content)
|
||||
content = handle_normal_video(content)
|
||||
content = handle_youtube(content)
|
||||
content = handle_vimeo(content)
|
||||
content = handle_dailymotion(content)
|
||||
content = handle_spotify(content)
|
||||
content = handle_soundcloud(content)
|
||||
end
|
||||
|
||||
# Examples:
|
||||
# 
|
||||
# 
|
||||
def handle_normal_audio(content)
|
||||
handle_media(content, {
|
||||
media_type: 'audio',
|
||||
host: '(https?:)?\\/\\/.*\\/',
|
||||
id: '(.+?\\.(mp3|wav|ogg|mid|midi|aac|wma))',
|
||||
})
|
||||
end
|
||||
|
||||
|
||||
# Examples:
|
||||
# 
|
||||
# 
|
||||
# 
|
||||
def handle_normal_video(content)
|
||||
handle_media(content, {
|
||||
media_type: 'iframe',
|
||||
host: '(https?:)?\\/\\/.*\\/',
|
||||
id: '(.+?\\.(avi|mp4|webm|ogg|ogv|flv|mkv|mov|wmv|3gp|rmvb|asf))'
|
||||
})
|
||||
end
|
||||
|
||||
# Examples:
|
||||
# 
|
||||
# 
|
||||
# 
|
||||
def handle_youtube(content)
|
||||
handle_media(content, {
|
||||
media_type: 'iframe',
|
||||
host: '(https?:)?\\/\\/.*youtu.*',
|
||||
id: '(?<=\\?v\\=|embed\\/|\\.be\\/)([a-zA-Z0-9\\_\\-]+)',
|
||||
base_url: "https://www.youtube.com/embed/"
|
||||
})
|
||||
end
|
||||
|
||||
# Examples:
|
||||
# 
|
||||
# 
|
||||
def handle_vimeo(content)
|
||||
handle_media(content, {
|
||||
media_type: 'iframe',
|
||||
host: '(https?:)?\\/\\/vimeo\\.com\\/',
|
||||
id: '([0-9]+)',
|
||||
base_url: "https://player.vimeo.com/video/"
|
||||
})
|
||||
end
|
||||
|
||||
# Examples:
|
||||
# 
|
||||
# 
|
||||
def handle_dailymotion(content)
|
||||
handle_media(content, {
|
||||
media_type: 'iframe',
|
||||
host: '(https?:)?\\/\\/.*dai.?ly.*',
|
||||
id: '(?<=video\\/|\\/)([a-zA-Z0-9\\_\\-]+)',
|
||||
base_url: "https://www.dailymotion.com/embed/video/"
|
||||
})
|
||||
end
|
||||
|
||||
# Examples:
|
||||
# 
|
||||
# 
|
||||
def handle_spotify(content)
|
||||
handle_media(content, {
|
||||
media_type: 'iframe',
|
||||
host: '(https?:)?\\/\\/open\\.spotify\\.com\\/track\\/',
|
||||
id: '(?<=track\\/)([a-zA-Z0-9\\_\\-]+)',
|
||||
base_url: "https://open.spotify.com/embed/track/",
|
||||
height: 80
|
||||
})
|
||||
end
|
||||
|
||||
# Examples:
|
||||
# 
|
||||
def handle_soundcloud(content)
|
||||
handle_media(content, {
|
||||
media_type: 'iframe',
|
||||
id_from: 'html',
|
||||
host: '(https?:)?\\/\\/soundcloud\\.com\\/.+\\/[^\\?]+',
|
||||
id: '(?<=soundcloud:\\/\\/sounds:)([0-9]+)',
|
||||
base_url: "https://w.soundcloud.com/player/?url="\
|
||||
"https%3A//api.soundcloud.com/tracks/",
|
||||
height: 125,
|
||||
})
|
||||
end
|
||||
|
||||
def handle_media(content, data)
|
||||
host = data[:host]
|
||||
return content if content.sub(/#{host}/, '').nil?
|
||||
|
||||
media_type = data[:media_type]
|
||||
base_url = data[:base_url]
|
||||
id = data[:id_from] === 'html' ? '()' : data[:id]
|
||||
url = "(#{host}#{id}\\S*)"
|
||||
title = '("(.*)".*){0,1}'
|
||||
|
||||
# pre-handle reference-style links
|
||||
regex = /(\[(.*)\]:\s*(#{url}\s*#{title}))/
|
||||
content.scan regex do |match_data|
|
||||
match = match_data[0]
|
||||
ref_name = match_data[1]
|
||||
ref_value = match_data[2]
|
||||
content = content.gsub(match, '')
|
||||
.gsub(/\!\[(.*)\]\s*\[#{ref_name}\]/,
|
||||
"")
|
||||
end
|
||||
|
||||
# handle inline-style links
|
||||
regex = /(\!\[(.*)\]\(.*#{url}\s*#{title}\))/
|
||||
content.scan regex do |match_data|
|
||||
url = match_data[2]
|
||||
id = data[:id_from] === 'html' \
|
||||
? get_id_from_html(url, data[:id]) \
|
||||
: match_data[4]
|
||||
title = match_data[6]
|
||||
qs = url.match(/(?<=\?)(\S*?)$/)
|
||||
qs = Hash[URI.decode_www_form(qs.to_s)].reject do |k, v|
|
||||
next true if v == id or v == ''
|
||||
end
|
||||
|
||||
cfg = self.config['default'].clone
|
||||
cfg['id'] = qs['id'] || cfg['id']
|
||||
cfg['class'] = qs['class'] || cfg['class']
|
||||
cfg['style'] = qs['style'] || cfg['style']
|
||||
cfg['id'] = cfg['id'].gsub('{id}', id)
|
||||
cfg['class'] = cfg['class'].gsub('{id}', id)
|
||||
|
||||
cfg['src'] = URI(base_url ? "#{base_url}#{id}" : url).tap do |v|
|
||||
v.query = URI.encode_www_form(qs) if qs.size > 0
|
||||
end
|
||||
|
||||
case media_type
|
||||
when 'audio'
|
||||
cfg['autoplay'] = qs['autoplay'] || data[:autoplay] || cfg['autoplay']
|
||||
cfg['loop'] = qs['loop'] || data[:loop] || cfg['loop']
|
||||
cfg['style'] += ';display: none;' if qs['hidden']
|
||||
content = handle_audio(content, { target: match_data[0], cfg: cfg })
|
||||
when 'iframe'
|
||||
cfg['title'] = title
|
||||
cfg['width'] = qs['width'] || data[:width] || cfg['width']
|
||||
cfg['height'] = qs['height'] || data[:height] || cfg['height']
|
||||
cfg['frameborder'] = qs['frameborder'] || cfg['frameborder']
|
||||
cfg['allow'] ||= cfg['allow']
|
||||
content = handle_iframe(content, { target: match_data[0], cfg: cfg })
|
||||
end
|
||||
self.handled = true
|
||||
end
|
||||
content
|
||||
end
|
||||
|
||||
def handle_audio(content, data)
|
||||
cfg = data[:cfg]
|
||||
html = "<audio"\
|
||||
" id=\"#{cfg['id']}\""\
|
||||
" class=\"#{cfg['class']}\""\
|
||||
" #{cfg['autoplay'] ? 'autoplay' : ''}"\
|
||||
" #{cfg['loop'] ? 'loop' : ''}"\
|
||||
" src=\"#{cfg['src']}\""\
|
||||
" style=\"#{cfg['style']}\""\
|
||||
" controls>" \
|
||||
"<p> Your browser doesn't support HTML5 audio."\
|
||||
" Here is a <a href=\"#{cfg['src']}\">link to download the audio</a>"\
|
||||
"instead. </p>"\
|
||||
"</audio>"
|
||||
content.gsub(data[:target], html)
|
||||
end
|
||||
|
||||
def handle_iframe(content, data)
|
||||
cfg = data[:cfg]
|
||||
html = "<iframe"\
|
||||
" id=\"#{cfg['id']}\""\
|
||||
" class=\"#{cfg['class']}\""\
|
||||
" src=\"#{cfg['src']}\""\
|
||||
" title=\"#{cfg['title']}\""\
|
||||
" width=\"#{cfg['width']}\""\
|
||||
" height=\"#{cfg['height']}\""\
|
||||
" style=\"#{cfg['style']}\""\
|
||||
" allow=\"#{cfg['allow']}\""\
|
||||
" frameborder=\"#{cfg['frameborder']}\""\
|
||||
" allowfullscreen>"\
|
||||
"</iframe>"
|
||||
content.gsub(data[:target], html)
|
||||
end
|
||||
|
||||
def get_id_from_html(url, pattern)
|
||||
id = ''
|
||||
begin
|
||||
url = 'https:' + url if url.start_with? '//'
|
||||
res = Net::HTTP.get_response URI(url)
|
||||
raise res.body unless res.is_a?(Net::HTTPSuccess)
|
||||
res.body.match pattern do |match_data|
|
||||
id = match_data[0]
|
||||
break
|
||||
end
|
||||
rescue StandardError => msg
|
||||
data = url
|
||||
logger.log msg
|
||||
end
|
||||
id
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -1,102 +0,0 @@
|
||||
# frozen_string_literal: true
|
||||
|
||||
require "net/http"
|
||||
require "base64"
|
||||
|
||||
module Jekyll::Spaceship
|
||||
class MermaidProcessor < Processor
|
||||
exclude :none
|
||||
|
||||
def self.config
|
||||
{
|
||||
'mode' => 'default',
|
||||
'syntax' => {
|
||||
'code' => 'mermaid!',
|
||||
'custom' => ['@startmermaid', '@endmermaid']
|
||||
},
|
||||
'css' => {
|
||||
'class' => 'mermaid'
|
||||
},
|
||||
'config': {
|
||||
'theme' => 'default'
|
||||
},
|
||||
'src' => 'https://mermaid.ink/svg/'
|
||||
}
|
||||
end
|
||||
|
||||
def on_handle_markdown(content)
|
||||
# match custom mermaid block and code block
|
||||
syntax = self.config['syntax']
|
||||
code_name = syntax['code']
|
||||
custom = syntax['custom'][-2, 2]
|
||||
|
||||
patterns = [
|
||||
/((`{3,})\s*#{code_name}((?:.|\n)*?)\2)/,
|
||||
/((?<!\\)(#{custom[0]})((?:.|\n)*?)(?<!\\)(#{custom[1]}))/
|
||||
]
|
||||
|
||||
patterns.each do |pattern|
|
||||
content = handle_mermaid_block(pattern, content)
|
||||
end
|
||||
|
||||
# handle escape custom mermaid block
|
||||
content.gsub(/\\(#{custom[0]}|#{custom[1]})/, '\1')
|
||||
end
|
||||
|
||||
def handle_mermaid_block(pattern, content)
|
||||
content.scan pattern do |match|
|
||||
match = match.select { |m| not m.nil? }
|
||||
block = match[0]
|
||||
code = match[2]
|
||||
|
||||
self.handled = true
|
||||
|
||||
content = content.gsub(
|
||||
block,
|
||||
handle_mermaid(code)
|
||||
)
|
||||
end
|
||||
content
|
||||
end
|
||||
|
||||
def handle_mermaid(code)
|
||||
# encode to UTF-8
|
||||
code = code.encode('UTF-8')
|
||||
url = get_url(code)
|
||||
|
||||
# render mode
|
||||
case self.config['mode']
|
||||
when 'pre-fetch'
|
||||
data = self.class.fetch_img_data(url)
|
||||
end
|
||||
if data.nil?
|
||||
data = { 'type' => 'url', 'body' => url }
|
||||
end
|
||||
|
||||
# return img tag
|
||||
data['class'] = self.config['css']['class']
|
||||
self.class.make_img_tag(data)
|
||||
end
|
||||
|
||||
def get_url(code)
|
||||
src = self.config['src']
|
||||
|
||||
# wrap code
|
||||
code = {
|
||||
'code' => code.gsub(/^\s*|\s*$/, ''),
|
||||
'mermaid' => config['config']
|
||||
}.to_json
|
||||
|
||||
# set default method
|
||||
src += '{code}' if src.match(/\{.*\}/).nil?
|
||||
|
||||
# encode to base64 string
|
||||
if src.include?('{code}')
|
||||
code = Base64.urlsafe_encode64(code, padding: false)
|
||||
return src.gsub('{code}', code)
|
||||
else
|
||||
raise "No supported src ! #{src}"
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -1,93 +1,52 @@
|
||||
# frozen_string_literal: true
|
||||
|
||||
require "net/http"
|
||||
require "base64"
|
||||
|
||||
module Jekyll::Spaceship
|
||||
class PlantumlProcessor < Processor
|
||||
exclude :none
|
||||
class PlantUMLProcessor < Processor
|
||||
register :posts, :pre_render
|
||||
|
||||
def self.config
|
||||
{
|
||||
'mode' => 'default',
|
||||
'syntax' => {
|
||||
'code' => 'plantuml!',
|
||||
'custom' => ['@startuml', '@enduml']
|
||||
},
|
||||
'css' => {
|
||||
'class' => 'plantuml'
|
||||
},
|
||||
'src' => 'http://www.plantuml.com/plantuml/svg/'
|
||||
}
|
||||
end
|
||||
def on_posts_pre_render(post)
|
||||
# match default plantuml block and code block
|
||||
pattern = Regexp.union(
|
||||
/(\\?@startuml((?:.|\n)*?)@enduml)/,
|
||||
/(`{3}\s*plantuml((?:.|\n)*?)`{3})/
|
||||
)
|
||||
|
||||
def on_handle_markdown(content)
|
||||
# match custom plantuml block and code block
|
||||
syntax = self.config['syntax']
|
||||
code_name = syntax['code']
|
||||
custom = syntax['custom'][-2, 2]
|
||||
|
||||
patterns = [
|
||||
/((`{3,})\s*#{code_name}((?:.|\n)*?)\2)/,
|
||||
/((?<!\\)(#{custom[0]})((?:.|\n)*?)(?<!\\)(#{custom[1]}))/
|
||||
]
|
||||
|
||||
patterns.each do |pattern|
|
||||
content = handle_plantuml_block(pattern, content)
|
||||
end
|
||||
|
||||
# handle escape custom plantuml block
|
||||
content.gsub(/\\(#{custom[0]}|#{custom[1]})/, '\1')
|
||||
end
|
||||
|
||||
def handle_plantuml_block(pattern, content)
|
||||
content.scan pattern do |match|
|
||||
post.content.scan pattern do |match|
|
||||
match = match.select { |m| not m.nil? }
|
||||
block = match[0]
|
||||
code = match[2]
|
||||
code = match[1]
|
||||
|
||||
self.handled = true
|
||||
# skip escape default plantuml block
|
||||
if block.match? /(^\\@startuml|\\@enduml$)/
|
||||
next
|
||||
end
|
||||
|
||||
content = content.gsub(
|
||||
Logger.log "handle plantuml block - #{post.path.gsub(/.*_posts\//, '')}"
|
||||
|
||||
post.content = post.content.gsub(
|
||||
block,
|
||||
handle_plantuml(code)
|
||||
)
|
||||
end
|
||||
content
|
||||
|
||||
# handle escape default plantuml block
|
||||
post.content = post.content.gsub(/\\(@startuml|@enduml)/, '\1')
|
||||
end
|
||||
|
||||
def handle_plantuml(code)
|
||||
# wrap plantuml code
|
||||
code = "@startuml#{code}@enduml".encode('UTF-8')
|
||||
url = self.get_url(code)
|
||||
uml = "@startuml#{code}@enduml"
|
||||
|
||||
# render mode
|
||||
case self.config['mode']
|
||||
when 'pre-fetch'
|
||||
data = self.class.fetch_img_data(url)
|
||||
end
|
||||
if data.nil?
|
||||
data = { 'type' => 'url', 'body' => url }
|
||||
end
|
||||
dir = File.dirname(__FILE__)
|
||||
jar = dir + "/../utils/plantuml/plantuml.jar"
|
||||
echo = "echo -e \"#{uml.gsub('"', '\"')}\""
|
||||
plantuml = "java -jar \"#{jar}\" -pipe 2>/dev/null"
|
||||
|
||||
# exec plantuml.jar and output base64 data
|
||||
base64 = `#{echo} | #{plantuml} | base64`
|
||||
|
||||
# return img tag
|
||||
data['class'] = self.config['css']['class']
|
||||
self.class.make_img_tag(data)
|
||||
end
|
||||
|
||||
def get_url(code)
|
||||
src = self.config['src']
|
||||
|
||||
# set default method
|
||||
src += '{hexcode}' if src.match(/\{.*\}/).nil?
|
||||
|
||||
# encode to hex string
|
||||
if src.include?('{hexcode}')
|
||||
code = '~h' + code.unpack("H*").first
|
||||
return src.gsub('{hexcode}', code)
|
||||
else
|
||||
raise "No supported src ! #{src}"
|
||||
end
|
||||
"<img src=\"data:image/png;base64, #{base64}\">"
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
@ -1,14 +0,0 @@
|
||||
# frozen_string_literal: true
|
||||
|
||||
module Jekyll::Spaceship
|
||||
class PolyfillProcessor < Processor
|
||||
priority :high
|
||||
|
||||
def on_handle_markdown(content)
|
||||
# escape ordered list.
|
||||
rexp = /(\s*)(?<!\\)\\(?=\d+\.)/
|
||||
self.handled = true if content.match(rexp)
|
||||
content.gsub(rexp, '\1⁣')
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -1,109 +1,24 @@
|
||||
# frozen_string_literal: true
|
||||
|
||||
require "ostruct"
|
||||
require "nokogiri"
|
||||
require 'nokogiri'
|
||||
|
||||
module Jekyll::Spaceship
|
||||
class TableProcessor < Processor
|
||||
ATTR_LIST_PATTERN = /((?<!\\)\{:(?:([A-Za-z]\S*):)?(.*?)(?<!\\)\})/
|
||||
ATTR_LIST_REFS = {}
|
||||
register :posts, :pre_render, :post_render
|
||||
|
||||
def on_handle_markdown(content)
|
||||
# pre-handle reference-style links
|
||||
references = {}
|
||||
content.scan(/\n\s*(\[(.*)\]:\s*(\S+(\s+".*?")?))/) do |match_data|
|
||||
ref_name = match_data[1]
|
||||
ref_value = match_data[2]
|
||||
references[ref_name] = ref_value
|
||||
end
|
||||
if references.size > 0
|
||||
content.scan(/[^\n]*(?<!\\)\|[^\n]*/) do |result|
|
||||
references.each do |key, val|
|
||||
replace = result.gsub(
|
||||
/\[([^\n\]]*?)\]\s*\[#{key}\]/,
|
||||
"[\1](#{val})")
|
||||
next if result == replace
|
||||
content = content.gsub(result, replace)
|
||||
end
|
||||
end
|
||||
def on_posts_pre_render(post)
|
||||
# pre-handle table in markdown
|
||||
post.content = post.content
|
||||
.gsub(/\|(?=\|)/, '\\|')
|
||||
.gsub(/\\:(?=.*?(?<!\\)\|)/, '\\\\\\\\:')
|
||||
.gsub(/((?<!\\)\|.*?)(\\:)/, '\1\\\\\\\\:')
|
||||
end
|
||||
|
||||
# pre-handle row-span
|
||||
content = content.gsub(/(?<!\\)(\|[^\n]*\\\s*)\|\s*\n/, "\\1\n")
|
||||
|
||||
# escape | and :
|
||||
content = content.gsub(/\|(?=\|)/, '\\|')
|
||||
.gsub(/\\:(?=[^\n]*?(?<!\\)\|)/, '\\\\\\\\:')
|
||||
.gsub(/((?<!\\)\|[^\n]*?)(\\:)/, '\1\\\\\\\\:')
|
||||
|
||||
# escape * and _ and $ etc.
|
||||
content.scan(/[^\n]*(?<!\\)\|[^\n]*/) do |result|
|
||||
# skip for math expression within pipeline
|
||||
next unless result
|
||||
.gsub(/((?<!\\)\${1,2})[^\n]*?\1/, '')
|
||||
.match(/(?<!\\)\|/)
|
||||
replace = result.gsub(
|
||||
/(?<!(?<!\\)\\)(\*|\$|\[|\(|\"|_)/, '\\\\\\\\\1')
|
||||
next if result == replace
|
||||
content = content.gsub(result, replace)
|
||||
end
|
||||
|
||||
# pre-handle attribute list (AL)
|
||||
ATTR_LIST_REFS.clear()
|
||||
content.scan(ATTR_LIST_PATTERN) do |result|
|
||||
ref = result[1]
|
||||
list = result[2]
|
||||
next if ref.nil?
|
||||
if ATTR_LIST_REFS.has_key? ref
|
||||
ATTR_LIST_REFS[ref] += list
|
||||
else
|
||||
ATTR_LIST_REFS[ref] = list
|
||||
end
|
||||
end
|
||||
content
|
||||
end
|
||||
|
||||
def on_handle_html(content)
|
||||
def on_posts_post_render(post)
|
||||
# use nokogiri to parse html content
|
||||
doc = Nokogiri::HTML(content)
|
||||
doc = Nokogiri::HTML(post.content)
|
||||
|
||||
data = self.table_scope_data
|
||||
|
||||
# handle each table
|
||||
doc.css('table').each do |table|
|
||||
next if table.ancestors('code, pre').size > 0
|
||||
rows = table.css('tr')
|
||||
data.table = table
|
||||
data.rows = rows
|
||||
data.reset.call :table
|
||||
rows.each do |row|
|
||||
cells = row.css('th, td')
|
||||
data.row = row
|
||||
data.cells = cells
|
||||
data.reset.call :row
|
||||
cells.each do |cell|
|
||||
data.cell = cell
|
||||
handle_colspan(data)
|
||||
handle_multi_rows(data)
|
||||
handle_text_align(data)
|
||||
handle_rowspan(data)
|
||||
handle_attr_list(data)
|
||||
end
|
||||
end
|
||||
rows.each do |row|
|
||||
cells = row.css('th, td')
|
||||
cells.each do |cell|
|
||||
data.cell = cell
|
||||
handle_format(data)
|
||||
end
|
||||
end
|
||||
self.handled = true
|
||||
end
|
||||
|
||||
doc.to_html
|
||||
end
|
||||
|
||||
def table_scope_data
|
||||
data = OpenStruct.new(_: OpenStruct.new)
|
||||
data.reset = ->(scope, namespace = nil) {
|
||||
data._.marshal_dump.each do |key, val|
|
||||
@ -121,99 +36,124 @@ module Jekyll::Spaceship
|
||||
end
|
||||
data._[namespace]
|
||||
}
|
||||
data
|
||||
|
||||
# handle each table
|
||||
doc.css('table').each do |table|
|
||||
rows = table.css('tr')
|
||||
data.table= table
|
||||
data.rows = rows
|
||||
data.reset.call :table
|
||||
rows.each do |row|
|
||||
cells = row.css('th, td')
|
||||
data.row = row
|
||||
data.cells = cells
|
||||
data.reset.call :row
|
||||
cells.each do |cell|
|
||||
data.cell = cell
|
||||
handle_colspan(data)
|
||||
handle_multi_rows(data)
|
||||
handle_text_align(data)
|
||||
handle_rowspan(data)
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
post.content = doc.at('body').inner_html
|
||||
end
|
||||
|
||||
def handle_colspan(data)
|
||||
scope = data.scope.call __method__
|
||||
scope_table = scope.table
|
||||
scope_row = scope.row
|
||||
cells = data.cells
|
||||
cell = data.cell
|
||||
|
||||
if scope.table.row != data.row
|
||||
scope.table.row = data.row
|
||||
scope.row.colspan = 0
|
||||
if scope_table.row != data.row
|
||||
scope_table.row = data.row
|
||||
scope_row.colspan = 0
|
||||
end
|
||||
|
||||
# handle colspan
|
||||
if cell == cells.last and scope.row.colspan > 0
|
||||
cells.count.downto(cells.count - scope.row.colspan + 1) do |i|
|
||||
c = cells[i - 1]
|
||||
return unless c.get_attribute('colspan').nil?
|
||||
c.remove
|
||||
result = cell.content.match(/(\s*\|)+$/)
|
||||
if cell == cells.last and scope_row.colspan > 0
|
||||
range = (cells.count - scope_row.colspan)...cells.count
|
||||
for i in range do
|
||||
cells[i].remove
|
||||
end
|
||||
end
|
||||
|
||||
result = cell.content.match(/(\|)+$/)
|
||||
return if result.nil?
|
||||
|
||||
cell.content = cell.content.gsub(/(\|)+$/, '')
|
||||
if result
|
||||
result = result[0]
|
||||
colspan = result.scan(/\|/).count
|
||||
scope.row.colspan += colspan
|
||||
cell.set_attribute('colspan', colspan + 1)
|
||||
scope_row.colspan += result.scan(/\|/).count
|
||||
cell.content = cell.content.gsub(/(\s*\|)+$/, "")
|
||||
cell.set_attribute("colspan", scope_row.colspan + 1)
|
||||
end
|
||||
end
|
||||
|
||||
def handle_multi_rows(data)
|
||||
scope = data.scope.call __method__
|
||||
scope_table = scope.table
|
||||
cells = data.cells
|
||||
row = data.row
|
||||
cell = data.cell
|
||||
|
||||
if scope.table.table != data.table
|
||||
scope.table.table = data.table
|
||||
scope.table.multi_row_cells = nil
|
||||
scope.table.multi_row_start = false
|
||||
if scope_table.table != data.table
|
||||
scope_table.table = data.table
|
||||
scope_table.multi_row_cells = nil
|
||||
scope_table.multi_row_start = false
|
||||
end
|
||||
|
||||
# handle multi-rows
|
||||
return if cell != cells.last
|
||||
|
||||
match = cell.content.match(/(?<!\\)\\\s*$/)
|
||||
match = cell.content.match?(/\\$/)
|
||||
if match
|
||||
cell.content = cell.content.gsub(/(?<!\\)\\\s*$/, '')
|
||||
if not scope.table.multi_row_start
|
||||
scope.table.multi_row_cells = cells
|
||||
scope.table.multi_row_start = true
|
||||
cell.content = cell.content.gsub(/\\$/, '')
|
||||
if not scope_table.multi_row_start
|
||||
scope_table.multi_row_cells = cells
|
||||
scope_table.multi_row_start = true
|
||||
end
|
||||
end
|
||||
|
||||
if scope.table.multi_row_cells != cells and scope.table.multi_row_start
|
||||
for i in 0...scope.table.multi_row_cells.count do
|
||||
multi_row_cell = scope.table.multi_row_cells[i]
|
||||
multi_row_cell.inner_html += "\n<br>\n#{cells[i].inner_html}"
|
||||
if scope_table.multi_row_cells != cells and scope_table.multi_row_start
|
||||
for i in 0...scope_table.multi_row_cells.count do
|
||||
scope_table.multi_row_cells[i].inner_html += "<br>#{cells[i].content}"
|
||||
end
|
||||
row.remove
|
||||
end
|
||||
scope.table.multi_row_start = false if not match
|
||||
scope_table.multi_row_start = false if not match
|
||||
end
|
||||
|
||||
def handle_rowspan(data)
|
||||
scope = data.scope.call __method__
|
||||
scope_table = scope.table
|
||||
scope_row = scope.row
|
||||
cell = data.cell
|
||||
cells = data.cells
|
||||
|
||||
if scope.table.table != data.table
|
||||
scope.table.table = data.table
|
||||
scope.table.span_row_cells = []
|
||||
if scope_table.table != data.table
|
||||
scope_table.table = data.table
|
||||
scope_table.span_row_cells = []
|
||||
end
|
||||
if scope.row.row != data.row
|
||||
scope.row.row = data.row
|
||||
scope.row.col_index = 0
|
||||
|
||||
if scope_row.row != data.row
|
||||
scope_row.row = data.row
|
||||
scope_row.col_index = 0
|
||||
end
|
||||
|
||||
# handle rowspan
|
||||
span_cell = scope.table.span_row_cells[scope.row.col_index]
|
||||
if span_cell and cell.content.match(/^\s*\^{2}/)
|
||||
cell.content = cell.content.gsub(/^\s*\^{2}/, '')
|
||||
span_cell.inner_html += "\n<br>\n#{cell.inner_html}"
|
||||
rowspan = span_cell.get_attribute('rowspan') || 1
|
||||
span_cell = scope_table.span_row_cells[scope_row.col_index]
|
||||
if span_cell and cell.content.match?(/^\^{2}/)
|
||||
cell.content = cell.content.gsub(/^\^{2}/, "")
|
||||
span_cell.inner_html += "<br>#{cell.content}"
|
||||
rowspan = span_cell.get_attribute("rowspan") || 1
|
||||
rowspan = rowspan.to_i + 1
|
||||
span_cell.set_attribute('rowspan', "#{rowspan}")
|
||||
span_cell.set_attribute("rowspan", "#{rowspan}")
|
||||
cell.remove
|
||||
else
|
||||
scope.table.span_row_cells[scope.row.col_index] = cell
|
||||
scope_table.span_row_cells[scope_row.col_index] = cell
|
||||
end
|
||||
scope.row.col_index += [cell.get_attribute('colspan').to_i, 1].max
|
||||
|
||||
scope_row.col_index += 1
|
||||
end
|
||||
|
||||
def handle_text_align(data)
|
||||
@ -221,102 +161,37 @@ module Jekyll::Spaceship
|
||||
|
||||
# pre-handle text align
|
||||
align = 0
|
||||
if cell.content.match(/^\s*:(?!:)/)
|
||||
cell.content = cell.content.gsub(/^\s*:/, '')
|
||||
if cell.content.match?(/^:(?!:)/)
|
||||
cell.content = cell.content.gsub(/^:/, "")
|
||||
align += 1
|
||||
end
|
||||
if cell.content.match(/(?<!\\):\s*$/)
|
||||
cell.content = cell.content.gsub(/:\s*$/, '')
|
||||
if cell.content.match?(/(?<!\\):$/)
|
||||
cell.content = cell.content.gsub(/:$/, "")
|
||||
align += 2
|
||||
end
|
||||
|
||||
# handle escape colon
|
||||
cell.content = cell.content.gsub(/\\:/, ":")
|
||||
|
||||
# handle text align
|
||||
return if align == 0
|
||||
|
||||
# handle escape colon
|
||||
cell.content = cell.content.gsub(/\\:/, ':')
|
||||
|
||||
style = cell.get_attribute('style')
|
||||
style = cell.get_attribute("style")
|
||||
if align == 1
|
||||
align = 'text-align: left'
|
||||
align = "text-align: left"
|
||||
elsif align == 2
|
||||
align = 'text-align: right'
|
||||
align = "text-align: right"
|
||||
elsif align == 3
|
||||
align = 'text-align: center'
|
||||
align = "text-align: center"
|
||||
end
|
||||
|
||||
# handle existed inline-style
|
||||
if style&.match(/text-align:.+/)
|
||||
if style&.match?(/text-align:.+/)
|
||||
style = style.gsub(/text-align:.+/, align)
|
||||
else
|
||||
style = align
|
||||
end
|
||||
cell.set_attribute('style', style)
|
||||
end
|
||||
|
||||
# Examples:
|
||||
# {:ref-name: .cls1 title="hello" }
|
||||
# {: #id ref-name data="world" }
|
||||
# {: #id title="hello" }
|
||||
# {: .cls style="color: #333" }
|
||||
def handle_attr_list(data)
|
||||
cell = data.cell
|
||||
content = cell.inner_html
|
||||
# inline attribute list(IAL) handler
|
||||
ial_handler = ->(list) do
|
||||
list.scan(/(\S+)=("|')(.*?)\2|(\S+)/) do |attr|
|
||||
key = attr[0]
|
||||
val = attr[2]
|
||||
single = attr[3]
|
||||
if !key.nil?
|
||||
val = (cell.get_attribute(key) || '') + val
|
||||
cell.set_attribute(key, val)
|
||||
elsif !single.nil?
|
||||
if single.start_with? '#'
|
||||
key = 'id'
|
||||
val = single[1..-1]
|
||||
elsif single.start_with? '.'
|
||||
key = 'class'
|
||||
val = cell.get_attribute(key) || ''
|
||||
val += (val.size.zero? ? '' : ' ') + single[1..-1]
|
||||
elsif ATTR_LIST_REFS.has_key? single
|
||||
ial_handler.call ATTR_LIST_REFS[single]
|
||||
end
|
||||
unless key.nil?
|
||||
cell.set_attribute(key, val)
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
# handle attribute list
|
||||
content.scan(ATTR_LIST_PATTERN) do |result|
|
||||
ref = result[1]
|
||||
list = result[2]
|
||||
# handle inline attribute list
|
||||
ial_handler.call list if ref.nil?
|
||||
# remove attr_list
|
||||
content = content.sub(result[0], '')
|
||||
end
|
||||
cell.inner_html = content
|
||||
end
|
||||
|
||||
def handle_format(data)
|
||||
cell = data.cell
|
||||
cvter = self.converter('markdown')
|
||||
return if cvter.nil?
|
||||
content = cell.inner_html
|
||||
content = self.pre_exclude(content, [/(\<code.*\>.*\<\/code\>)/])
|
||||
.gsub(/(?<!\\)\|/, '\\|')
|
||||
.gsub(/^\s+|\s+$/, '')
|
||||
.gsub(/</, '<')
|
||||
.gsub(/>/, '>')
|
||||
content = self.post_exclude(content)
|
||||
content = cvter.convert(content)
|
||||
content = Nokogiri::HTML.fragment(content)
|
||||
if content.children.first&.name == 'p'
|
||||
content = content.children
|
||||
end
|
||||
cell.inner_html = content.inner_html
|
||||
cell.set_attribute("style", style)
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
BIN
lib/jekyll-spaceship/utils/plantuml/plantuml.jar
Normal file
BIN
lib/jekyll-spaceship/utils/plantuml/plantuml.jar
Normal file
Binary file not shown.
@ -2,6 +2,6 @@
|
||||
|
||||
module Jekyll
|
||||
module Spaceship
|
||||
VERSION = "0.9.3"
|
||||
VERSION = "0.2.1"
|
||||
end
|
||||
end
|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 59 KiB |
@ -1,6 +0,0 @@
|
||||
#! /bin/bash
|
||||
|
||||
set -e
|
||||
|
||||
script/test
|
||||
bundle exec rake build
|
||||
@ -1,4 +0,0 @@
|
||||
#!/bin/bash
|
||||
set -ex
|
||||
|
||||
bundle exec rspec "$@"
|
||||
@ -1,100 +0,0 @@
|
||||
# This file was generated by the `rspec --init` command. Conventionally, all
|
||||
# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
|
||||
# The generated `.rspec` file contains `--require spec_helper` which will cause
|
||||
# this file to always be loaded, without a need to explicitly require it in any
|
||||
# files.
|
||||
#
|
||||
# Given that it is always loaded, you are encouraged to keep this file as
|
||||
# light-weight as possible. Requiring heavyweight dependencies from this file
|
||||
# will add to the boot time of your test suite on EVERY test run, even for an
|
||||
# individual file that may not need all of that loaded. Instead, consider making
|
||||
# a separate helper file that requires the additional dependencies and performs
|
||||
# the additional setup, and require it from the spec files that actually need
|
||||
# it.
|
||||
#
|
||||
# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
|
||||
RSpec.configure do |config|
|
||||
# rspec-expectations config goes here. You can use an alternate
|
||||
# assertion/expectation library such as wrong or the stdlib/minitest
|
||||
# assertions if you prefer.
|
||||
config.expect_with :rspec do |expectations|
|
||||
# This option will default to `true` in RSpec 4. It makes the `description`
|
||||
# and `failure_message` of custom matchers include text for helper methods
|
||||
# defined using `chain`, e.g.:
|
||||
# be_bigger_than(2).and_smaller_than(4).description
|
||||
# # => "be bigger than 2 and smaller than 4"
|
||||
# ...rather than:
|
||||
# # => "be bigger than 2"
|
||||
expectations.include_chain_clauses_in_custom_matcher_descriptions = true
|
||||
end
|
||||
|
||||
# rspec-mocks config goes here. You can use an alternate test double
|
||||
# library (such as bogus or mocha) by changing the `mock_with` option here.
|
||||
config.mock_with :rspec do |mocks|
|
||||
# Prevents you from mocking or stubbing a method that does not exist on
|
||||
# a real object. This is generally recommended, and will default to
|
||||
# `true` in RSpec 4.
|
||||
mocks.verify_partial_doubles = true
|
||||
end
|
||||
|
||||
# This option will default to `:apply_to_host_groups` in RSpec 4 (and will
|
||||
# have no way to turn it off -- the option exists only for backwards
|
||||
# compatibility in RSpec 3). It causes shared context metadata to be
|
||||
# inherited by the metadata hash of host groups and examples, rather than
|
||||
# triggering implicit auto-inclusion in groups with matching metadata.
|
||||
config.shared_context_metadata_behavior = :apply_to_host_groups
|
||||
|
||||
# The settings below are suggested to provide a good initial experience
|
||||
# with RSpec, but feel free to customize to your heart's content.
|
||||
=begin
|
||||
# This allows you to limit a spec run to individual examples or groups
|
||||
# you care about by tagging them with `:focus` metadata. When nothing
|
||||
# is tagged with `:focus`, all examples get run. RSpec also provides
|
||||
# aliases for `it`, `describe`, and `context` that include `:focus`
|
||||
# metadata: `fit`, `fdescribe` and `fcontext`, respectively.
|
||||
config.filter_run_when_matching :focus
|
||||
|
||||
# Allows RSpec to persist some state between runs in order to support
|
||||
# the `--only-failures` and `--next-failure` CLI options. We recommend
|
||||
# you configure your source control system to ignore this file.
|
||||
config.example_status_persistence_file_path = "spec/examples.txt"
|
||||
|
||||
# Limits the available syntax to the non-monkey patched syntax that is
|
||||
# recommended. For more details, see:
|
||||
# - http://rspec.info/blog/2012/06/rspecs-new-expectation-syntax/
|
||||
# - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
|
||||
# - http://rspec.info/blog/2014/05/notable-changes-in-rspec-3/#zero-monkey-patching-mode
|
||||
config.disable_monkey_patching!
|
||||
|
||||
# This setting enables warnings. It's recommended, but in some cases may
|
||||
# be too noisy due to issues in dependencies.
|
||||
config.warnings = true
|
||||
|
||||
# Many RSpec users commonly either run the entire suite or an individual
|
||||
# file, and it's useful to allow more verbose output when running an
|
||||
# individual spec file.
|
||||
if config.files_to_run.one?
|
||||
# Use the documentation formatter for detailed output,
|
||||
# unless a formatter has already been configured
|
||||
# (e.g. via a command-line flag).
|
||||
config.default_formatter = "doc"
|
||||
end
|
||||
|
||||
# Print the 10 slowest examples and example groups at the
|
||||
# end of the spec run, to help surface which specs are running
|
||||
# particularly slow.
|
||||
config.profile_examples = 10
|
||||
|
||||
# Run specs in random order to surface order dependencies. If you find an
|
||||
# order dependency and want to debug it, you can fix the order by providing
|
||||
# the seed, which is printed after each run.
|
||||
# --seed 1234
|
||||
config.order = :random
|
||||
|
||||
# Seed global randomization in this process using the `--seed` CLI option.
|
||||
# Setting this allows you to use `--seed` to deterministically reproduce
|
||||
# test failures related to randomization by passing the same `--seed` value
|
||||
# as the one that triggered the failure.
|
||||
Kernel.srand config.seed
|
||||
=end
|
||||
end
|
||||
Loading…
x
Reference in New Issue
Block a user