Skip to content

Latest commit

 

History

History
68 lines (44 loc) · 4.06 KB

README.md

File metadata and controls

68 lines (44 loc) · 4.06 KB

GitHub release (latest SemVer) Join the chat at https://gitter.im/Wyam2/Wyam2

Nuget Chocolatey GitHub release (latest by SemVer)

Wyam2 build Wyam2 nightly build GitHub commit activity

A continuation of the awesome project Wyam created by Dave Glick since it's the only open-source, cross-platform .NET documentation project that I know of, except docFX. For Windows-only there is also Sandcastle.

Wyam2

Wyam2 is a simple to use, highly modular, and extremely configurable static content generator that can be used to generate web sites, produce documentation, create ebooks, and much more. Since everything is configured by chaining together flexible modules (that you can even write yourself), the only limits to what it can create are your imagination.

The easiest way to get started is to install as a .NET Core global tool and use a recipe and theme.

  1. Download and install Wyam as a global tool:

    dotnet tool install -g Wyam2.Tool

  2. Scaffold a new blog:

    wyam2 new --recipe Blog

  3. Edit the scaffolded files.

  4. Build the blog with a theme:

    wyam2 --recipe Blog --theme CleanBlog

To go deeper, read more about the underlying concepts and then read about configuration files and the available command line arguments. Then check out the full list of modules.

For more information see Wyam2.
For questions and everything else

Contributing

For more details about how you can help this project, see this.

For details on building this project, see this.

History

  • up to v2.2.9
    • builds are provided by original project, Wyam
    • dotnet tool is Wyam.Tool and wyam
  • from v3.0.0
    • builds are provided by this fork Wyam2
    • dotnet tool is called Wyam2.Tool and wyam2

Acknowledgements

  • Original project Wyam under MIT license.
  • Portions of the IO support were originally inspired from Cake under MIT license.
  • The RSS/Atom support was originally ported from WebFeeds under MIT license.
  • Themes:
  • Many other fantastic OSS libraries are used directly as NuGet packages, thanks to all the OSS authors out there!