Add --render-markdowns command flag and renderMarkdown spec option

CHANGELOG.md

@@ -8,6 +8,7 @@
 - Config setting presets can now also be loaded from the main bundle when bundling XcodeGenKit #1135 @SofteqDG
 - Added ability to generate multiple projects in one XcodeGen launch #1270 @skofgar
 - Use memoization during recursive SpecFiles creation. This provides a drastic performance boost with lots of recursive includes #1275 @ma-oli
+- Added `--render-markdowns` command flag to generate the `.xcodesamplecode.plist` inside the project container and let Xcode render the markdown files with `md` extension.
 
 ### Fixed
 

Sources/XcodeGenCLI/Commands/GenerateCommand.swift

@@ -22,6 +22,9 @@ class GenerateCommand: ProjectCommand {
 
  @Flag("--only-plists", description: "Generate only plist files")
  var onlyPlists: Bool
+
+ @Flag("--render-markdowns", description: "Render markdown files with `.md` extension")
+ var renderMarkdowns: Bool
 
  init(version: Version) {
  super.init(version: version,
@@ -115,6 +118,16 @@ class GenerateCommand: ProjectCommand {
  } catch {
  throw GenerationError.writingError(error)
  }
+
+ // add markdown renderer if needed
+ if renderMarkdowns {
+ do {
+ try fileWriter.writeMarkdownRendererPlist()
+ success("Xcode markdown rendering enabled")
+ } catch {
+ throw GenerationError.writingError(error)
+ }
+ }
 
  // write cache
  if let cacheFile = cacheFile {

Sources/XcodeGenKit/FileWriter.swift

@@ -40,6 +40,11 @@ public class FileWriter {
  }
  }
  }
+
+ public func writeMarkdownRendererPlist() throws {
+ let path = project.defaultProjectPath + ".xcodesamplecode.plist"
+ try writePlist([:], path: path.string)
+ }
 
  private func writePlist(_ plist: [String: Any], path: String) throws {
  let path = project.basePath + path