conventional-changelog-gitmoji-config

conventional-changelog-gitmoji-config

sharable conventional changelog configuration for gitmoji style commit

Configuration File

conventional-changelog-gitmoji-config uses cosmiconfig to find and load your configuration object. Starting from the current working directory, it looks for the following possible sources:

• a changelog property in package.json
• a .changelogrc file
• a changelog.config.js file exporting a JS object

The .changelogrc file (without extension) can be in JSON or YAML format. You can add a filename extension to help your text editor provide syntax checking and highlighting:

• .changelogrc.json
• .changelogrc.yaml / .changelogrc.yml
• .changelogrc.js

The configuration object has the following signature:

interface ChangelogConfig {
  /**
   * map the scope to display name
   *
   * for example
   * {
   *     'config': 'commitlint-gitmoji-config'
   * }
   * will map all config 'scope' to 'commitlint-gitmoji-config' in the changelog
   * @default { }
   */
  scopeDisplayName?: Record<string, string>;
  /**
   * display types
   * @default undefined
   */
  displayTypes?: string[];
  /**
   * whether to include emoji in title
   * @default true
   */
  withEmoji?: boolean;
  /**
   * title language
   * @default en-US
   */
  titleLanguage?: 'en-US' | 'zh-CN' | 'mix';
  /**
   * whether to show author
   * @default false
   */
  showAuthor?: boolean;
  /**
   * whether to show author avatar
   * @default false
   */
  showAuthorAvatar?: boolean;
  /**
   * whether to show summary
   * @default false
   */
  showSummary?: boolean;
  /**
   * Reduce heading level from # to ##
   * @default false
   */
  reduceHeadingLevel?: boolean;
  /**
   * put timestamp to second line
   * @default false
   */
  newlineTimestamp?: boolean;
  /**
   * add back to top button
   * @default false
   */
  addBackToTop?: boolean;
  /**
   * Custom type display map
   */
  customTypeMap?: { [key in CommitTypes]?: CustomTypeNameMap };
}

👉 Tip: If turn on back to top button, should edit CHANGELOG.md first like below:

<a name="readme-top"></a>

# Changelog

License

MIT ® Arvin Xu