/// <summary>
/// Sets the Site Source directory, the directory where Jekyll will read files (defaults to `./`).
/// -s, --source DIR
/// </summary>
/// <param name="settings">The settings.</param>
/// <param name="sourceDirectoryPath">The source directory (defaults to `./`).</param>
/// <returns>The <paramref name="settings"/> instance with updated with the <paramref name="sourceDirectoryPath"/> provided.</returns>
public static JekyllNewThemeSettings SetSource(this JekyllNewThemeSettings settings, DirectoryPath sourceDirectoryPath)
{
if (settings is null)
{
throw new ArgumentNullException(nameof(settings));
}
settings.Source = sourceDirectoryPath;
return(settings);
}
/// <summary>
/// Specifies if Bundler should not be used to execute Jekyll.
/// `jekyll` instead of `bundle exec`...
/// </summary>
/// <param name="settings">The settings.</param>
/// <param name="enable"><see langword="true"/> to use Bundler to execute Jekyll, otherwise <see langword="false"/>.</param>
/// <exception cref="ArgumentNullException"/>
/// <returns>The <paramref name="settings"/> instance with the <see cref="JekyllSettings.DoNotUseBundler"/> property updated with the value provided in <paramref name="enable"/>.</returns>
public static JekyllNewThemeSettings DoNotUseBundler(this JekyllNewThemeSettings settings, bool?enable = true)
{
if (settings is null)
{
throw new ArgumentNullException(nameof(settings));
}
settings.DoNotUseBundler = enable;
return(settings);
}
/// <summary>
/// Sets if a Code of Conduct should be included.
/// --code-of-conduct
/// </summary>
/// <param name="settings">The settings.</param>
/// <param name="enable"><see langword="true"/> to publish posts with a future date, otherwise <see langword="false"/>.</param>
/// <returns>The <paramref name="settings"/> instance with the <see cref="JekyllNewThemeSettings.CodeOfConduct"/> property updated with the value provided in <paramref name="enable"/>.</returns>
public static JekyllNewThemeSettings IncludeCodeOfConduct(this JekyllNewThemeSettings settings, bool enable = true)
{
if (settings is null)
{
throw new ArgumentNullException(nameof(settings));
}
settings.CodeOfConduct = enable;
return(settings);
}
/// <summary>
/// Sets if the full backtrace should be shown when an error occurs.
/// -t, --trace
/// </summary>
/// <param name="settings">The settings.</param>
/// <param name="enable"><see langword="true"/> to show the full backtrace when an error occurs, otherwise <see langword="false"/>.</param>
/// <returns>The <paramref name="settings"/> instance with the <see cref="JekyllNewThemeSettings.Trace"/> property updated with the value provided in <paramref name="enable"/>.</returns>
public static JekyllNewThemeSettings EnableTrace(this JekyllNewThemeSettings settings, bool enable = true)
{
if (settings is null)
{
throw new ArgumentNullException(nameof(settings));
}
settings.Trace = enable;
return(settings);
}
/// <summary>
/// Sets the layout directory instead of using `_layouts/` automatically
/// --layouts DIR
/// </summary>
/// <param name="settings">The settings.</param>
/// <param name="layoutsDirectory">The layouts directory (defaults to ./_layouts).</param>
/// <returns>The <paramref name="settings"/> instance with updated with the <paramref name="layoutsDirectory"/> provided.</returns>
public static JekyllNewThemeSettings SetLayouts(this JekyllNewThemeSettings settings, DirectoryPath layoutsDirectory)
{
if (settings is null)
{
throw new ArgumentNullException(nameof(settings));
}
settings.Layouts = layoutsDirectory;
return(settings);
}
/// <summary>
/// Sets the Plugins directory instead of using `_plugins/` automatically.
/// -p, --plugins DIR1[,DIR2,...]
/// </summary>
/// <param name="settings">The settings.</param>
/// <param name="pluginDirectoryPaths">One or more plugin directory path(s).</param>
/// <returns>The <paramref name="settings"/> instance with updated with the <paramref name="pluginDirectoryPaths"/> provided.</returns>
public static JekyllNewThemeSettings WithPlugins(this JekyllNewThemeSettings settings, params DirectoryPath[] pluginDirectoryPaths)
{
if (settings is null)
{
throw new ArgumentNullException(nameof(settings));
}
settings.Plugins = pluginDirectoryPaths;
return(settings);
}
/// <summary>
/// Sets the Site Destination directory (defaults to `./_site`).
/// -d, --destination DIR
/// </summary>
/// <param name="settings">The settings.</param>
/// <param name="destinationDirectoryPath">The destination directory (defaults to `./_site`).</param>
/// <returns>The <paramref name="settings"/> instance with updated with the <paramref name="destinationDirectoryPath"/> provided.</returns>
public static JekyllNewThemeSettings SetDestination(this JekyllNewThemeSettings settings, DirectoryPath destinationDirectoryPath)
{
if (settings is null)
{
throw new ArgumentNullException(nameof(settings));
}
settings.Destination = destinationDirectoryPath;
return(settings);
}
/// <summary>
/// Sets the working directory which should be used to run the Jekyll command.
/// </summary>
/// <param name="settings">The settings.</param>
/// <param name="path">Working directory which should be used to run the Jekyll command.</param>
/// <exception cref="ArgumentNullException"/>
/// <returns>The <paramref name="settings"/> instance with <see cref="Cake.Core.Tooling.ToolSettings.WorkingDirectory"/> set to <paramref name="path"/>.</returns>
public static JekyllNewThemeSettings SetWorkingDirectory(this JekyllNewThemeSettings settings, DirectoryPath path)
{
if (settings is null)
{
throw new ArgumentNullException(nameof(settings));
}
if (path is null)
{
throw new ArgumentNullException(nameof(path));
}
settings.WorkingDirectory = path;
return(settings);
}