Method createChallenge

curriculum/src/build-superblock.ts:314–343

* Creates a challenge from a markdown file * @param {object} options - Options object * @param {string} options.filename - Name of the challenge file * @param {string} options.block - Name of the block * @param {object} options.meta - Meta information for the block * @param {boolean}

(
    {
      filename,
      block,
      meta,
      isAudited
    }: { filename: string; block: string; meta: Meta; isAudited: boolean },
    parser = parseMD
  )

   * @returns {Promise<object>} The finalized challenge object
   */
  async createChallenge(
    {
      filename,
      block,
      meta,
      isAudited
    }: { filename: string; block: string; meta: Meta; isAudited: boolean },
    parser = parseMD
  ) {
    log(
      `Creating challenge from file: ${filename} in block: ${block}, using lang: ${this.lang}`
    );

    const englishPath = resolve(this.blockContentDir, block, filename);
    const i18nPath = resolve(this.i18nBlockContentDir, block, filename);

    const langUsed = isAudited && existsSync(i18nPath) ? this.lang : 'english';

    const challengePath = langUsed === 'english' ? englishPath : i18nPath;

    const challenge = translateCommentsInChallenge(
      await parser(challengePath),
      langUsed,
      this.commentTranslations
    );

    challenge.translationPending = this.lang !== 'english' && !isAudited;

    return finalizeChallenge(challenge, meta);
  }

  /**
   * Reads and builds all challenges from a block directory