ze0nc/swiftpygmentspublishplugin

Requirements

• Python
• Pygments: https://pygments.org
• Swift 5
• Pygments color scheme in your .css file

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.

1. 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

Package Metadata

Repository: ze0nc/swiftpygmentspublishplugin

Default branch: master

README: README.md