Function docuHash

packages/docusaurus-utils/src/hashUtils.ts:28–55

(
  strInput: string,
  options?: {
    // String that contributes to the hash value
    // but does not contribute to the returned string
    hashExtra?: string;
    // Length of the hash to append
    hashLength?: number;
  },
)

 * filename per OS, avoiding `ERRNAMETOOLONG` error.
 */
export function docuHash(
  strInput: string,
  options?: {
    // String that contributes to the hash value
    // but does not contribute to the returned string
    hashExtra?: string;
    // Length of the hash to append
    hashLength?: number;
  },
): string {
  // TODO check this historical behavior
  //  I'm not sure it makes sense to keep it...
  if (strInput === '/' && typeof options?.hashExtra === 'undefined') {
    return 'index';
  }
  const str = strInput === '/' ? 'index' : strInput;

  const hashExtra = options?.hashExtra ?? '';
  const hashLength = options?.hashLength ?? 3;

  const stringToHash = str + hashExtra;
  const shortHash = simpleHash(stringToHash, hashLength);
  const parsedPath = `${_.kebabCase(str)}-${shortHash}`;
  if (isNameTooLong(parsedPath)) {
    return `${shortName(_.kebabCase(str))}-${shortHash}`;
  }
  return parsedPath;
}