获取

[dependencies]
hyperbuild = { version = "0.2.4", features = ["js-esbuild"] }

使用js-esbuild功能构建需要安装Go编译器，以构建JS压缩器。

如果未启用js-esbuild功能，则cfg.minify_js将没有效果。

使用

use hyperbuild::{Cfg, FriendlyError, hyperbuild, hyperbuild_copy, hyperbuild_friendly_error, hyperbuild_truncate};

fn main() {
    let mut code = b"<p>  Hello, world!  </p>".to_vec();
    let cfg = &Cfg {
        minify_js: false,
    };

    // Minifies a slice in-place and returns the new minified length,
    // but leaves any original code after the minified code intact.
    match hyperbuild(&mut code, cfg) {
        Ok(minified_len) => {}
        Err((error_type, error_position)) => {}
    };

    // Creates a vector copy containing only minified code
    // instead of minifying in-place.
    match hyperbuild_copy(&code, cfg) {
        Ok(minified) => {}
        Err((error_type, error_position)) => {}
    };

    // Minifies a vector in-place, and then truncates the
    // vector to the new minified length.
    match hyperbuild_truncate(&mut code, cfg) {
        Ok(()) => {}
        Err((error_type, error_position)) => {}
    };

    // Identical to `hyperbuild` except with FriendlyError instead.
    // `code_context` is a string of a visual representation of the source,
    // with line numbers and position markers to aid in debugging syntax.
    match hyperbuild_friendly_error(&mut code, cfg) {
        Ok(minified_len) => {}
        Err(FriendlyError { position, message, code_context }) => {
            eprintln!("Failed at character {}:", position);
            eprintln!("{}", message);
            eprintln!("{}", code_context);
        }
    };
}

hyperbuild 在 npm 上 可用，作为一个 Node.js 原生模块，并支持 Node.js 8 及以上版本。

获取

使用 npm

npm i hyperbuild

使用 Yarn

yarn add hyperbuild

使用

const hyperbuild = require("hyperbuild");

const cfg = { minifyJs: false };
const minified = hyperbuild.minify("<p>  Hello, world!  </p>", cfg);

// Alternatively, minify in place to avoid copying.
const source = Buffer.from("<p>  Hello, world!  </p>", cfg);
hyperbuild.minifyInPlace(source);

hyperbuild 也适用于 TypeScript

import * as hyperbuild from "hyperbuild";
import * as fs from "fs";

const cfg = { minifyJs: false };
const minified = hyperbuild.minify("<p>  Hello, world!  </p>", cfg);
hyperbuild.minifyInPlace(fs.readFileSync("source.html"), cfg);

hyperbuild 通过 JNI 提供，并支持 Java 7 及以上版本。

获取

作为 Maven 依赖添加

<dependency>
  <groupId>in.wilsonl.hyperbuild</groupId>
  <artifactId>hyperbuild</artifactId>
  <version>0.2.4</version>
</dependency>

使用

import in.wilsonl.hyperbuild.Hyperbuild;

Hyperbuild.Configuration cfg = new Hyperbuild.Configuration.Builder()
    .setMinifyJs(false)
    .build();
try {
    String minified = Hyperbuild.minify("<p>  Hello, world!  </p>", cfg);
} catch (Hyperbuild.SyntaxException e) {
    System.err.println(e.getMessage());
}

// Alternatively, minify in place:
assert source instanceof ByteBuffer && source.isDirect();
Hyperbuild.minifyInPlace(source, cfg);

hyperbuild 在 PyPI 上可用，作为一个 原生模块，并支持 CPython (默认 Python 解释器) 3.5 及以上版本。

获取

将 PyPI 项目作为依赖项添加，并使用 pip 或 pipenv 进行安装。

使用

import hyperbuild

try:
    minified = hyperbuild.minify("<p>  Hello, world!  </p>", minify_js=False)
except SyntaxError as e:
    print(e)

hyperbuild 已发布于 RubyGems，作为一个适用于 macOS 和 Linux 的 原生模块，并支持 Ruby 2.5 及以上版本。

获取

将库作为依赖项添加到 Gemfile 或 *.gemspec。

使用

require 'hyperbuild'

print Hyperbuild.minify("<p>  Hello, world!  </p>", { :minify_js => false })

适用对象：除 空白字符敏感 元素之外的所有元素。

将文本节点中的空白字符序列减少到单个空格 (U+0020)。

<p>↵
··The·quick·brown·fox↵
··jumps·over·the·lazy↵
··dog.↵
</p>

<p>·The·quick·brown·fox·jumps·over·the·lazy·dog.·</p>

适用对象：除 空白字符敏感、内容、内容优先 和 格式化 元素之外的所有元素。

移除位于标签之间且只包含空白字符的任何文本节点。

<ul>↵
··<li>A</li>↵
··<li>B</li>↵
··<li>C</li>↵
</ul>

<ul>↵
··<li>A</li><li>B</li><li>C</li>↵
</ul>

适用对象：除 空白字符敏感 和 格式化 元素之外的所有元素。

移除任何标签的前导/尾随空白字符。

<p>↵
··Hey,·I·<em>just</em>·found↵
··out·about·this·<strong>cool</strong>·website!↵
··<sup>[1]</sup>↵
</p>

<p>Hey,·I·<em>just</em>·found↵
··out·about·this·<strong>cool</strong>·website!↵
··<sup>[1]</sup></p>

空白字符被合并。

格式化元素通常是内联元素，它们围绕内容元素中的某些文本进行包装，因此其空白字符不会被裁剪，因为它们可能是内容的一部分。

空白字符被裁剪和合并。

内容元素通常代表一个连续的完整内容单元，如段落。因此，空白字符很重要，但它们的序列很可能是由于格式化导致的。

之前

<p>↵
··Hey,·I·<em>just</em>·found↵
··out·about·this·<strong>cool</strong>·website!↵
··<sup>[1]</sup>↵
</p>

之后

<p>Hey,·I·<em>just</em>·found·out·about·this·<strong>cool</strong>·website!·<sup>[1]</sup></p>

空白字符被裁剪和合并。整个空白字符被移除。

这些元素应只包含其他元素，不包含任何文本。这使得可以移除整个空白字符，这在使用 display: inline-block 时非常有用，这样元素之间的空白字符（例如缩进）就不会改变布局和样式。

之前

<ul>↵
··<li>A</li>↵
··<li>B</li>↵
··<li>C</li>↵
</ul>

之后

<ul><li>A</li><li>B</li><li>C</li></ul>

空白字符被裁剪和合并。

这些元素通常像内容元素一样，但偶尔也会用作具有一个子元素的布局元素。整个空白不会删除，因为它可能包含内容，但作为布局使用是可以的，因为只有一个子元素，空白会被修剪。

之前

<li>↵
··<article>↵
····<section></section>↵
····<section></section>↵
··</article>↵
</li>

之后

<li><article><section></section><section></section></article></li>