SwiftPygmentsPublishPlugin

master

SwiftPygments Plug in for Publish
Ze0nC/SwiftPygmentsPublishPlugin

SwiftPygments Plugin for Publish

A Pygments plugin for Publish to highlight code.

Pygments is a syntax highlighting tool made in Python that supports many languages.

Requirements

SwiftPygments uses PythonKit to interact with Pygments.

Installation

  1. Install Python if you don't have it on your system.
  2. Install Pygments if you don't have it on your system.
$ pip3 install pygments
  1. Add SwiftPygmentsPublishPlugin to your package.
let package = Package(
    ...
    dependencies: [
    .package(url: "https://github.com/Ze0nC/SwiftPygmentsPublishPlugin", .branch("master"))
    ],
    targets: [
        .target(
            ...
            dependencies: [
                ...
                "SwiftPygmentsPublishPlugin"
            ]
        )
    ]
    ...
)

Usage

  1. Add .pygments() to your build pipeline.
import SwiftPygmentsPublishPlugin
...
try MyWebsite().publish(using: [
    .installPlugin(.pygments()),
    ...
    .addMarkdownFiles(),
    ...
])
  1. Add a pygments color scheme in your css file. You can find many on internet.

  2. Write highlighted codes!

In your markdown file, specify language after ``` to get correct highlight.

```swift
let str = "This is Swift code."
print(str)
```

Specify code as python

```python
str = "This is also Swift code."
print(str)
```

If no language is specified, swift syntax will be used as default.

```
let str = "This is also Swift code."
print(str)
```

Note

This plugin will highlight all code block but not inline codes.

Enjoy your highlighted sites!

Acknowledgement

Thanks to John Sundell (@johnsundell) for creating Publish and SplashPublishPlugin

License

MIT License

Description

  • Swift Tools 5.5.0
View More Packages from this Author

Dependencies

Last updated: Mon Apr 15 2024 10:09:35 GMT-0900 (Hawaii-Aleutian Daylight Time)