feat: add disableHtmlExt config feature

src/constants.ts

@@ -133,6 +133,8 @@ export const REGEXP_INCLUDE_FILE_PATH = /(?<=[(]).+(?=[)])/g;
 // Regexp result: authorLogin
 export const REGEXP_AUTHOR = /(?<=author:\s).+(?=\r?\n)/g;
 
+export const REGEXP_EXT_HTML = /(\.html)$/gi;
+
 export const MIN_CHUNK_SIZE = Number(process.env.MIN_CHUNK_SIZE) || 1000;
 export const WORKERS_COUNT = Number(process.env.WORKERS_COUNT) || os.cpus().length - 1;
 export const PAGE_PROCESS_CONCURRENCY = Number(process.env.PAGE_PROCESS_CONCURRENCY) || 500;

src/models.ts

@@ -44,6 +44,7 @@ interface YfmConfig {
     connector?: VCSConnectorConfig;
     lang?: Lang;
     langs?: Lang[];
+    disableHtmlExt: boolean;
     lintDisabled: boolean;
     buildDisabled: boolean;
     lintConfig: LintConfig;

src/resolvers/md2html.ts

@@ -82,7 +82,7 @@ const getFileProps = async (options: ResolverOptions) => {
     const pathToFileDir: string =
         pathToDir === tocBase ? '' : pathToDir.replace(`${tocBase}${sep}`, '');
 
-    const {lang: configLang, langs: configLangs} = ArgvService.getConfig();
+    const {lang: configLang, langs: configLangs, disableHtmlExt} = ArgvService.getConfig();
     const meta = await getFileMeta(options);
 
     const tocBaseLang = tocBase?.split('/')[0];
@@ -94,7 +94,7 @@ const getFileProps = async (options: ResolverOptions) => {
     const props = {
         data: {
             leading: inputPath.endsWith('.yaml'),
-            toc: transformToc(toc) || {},
+            toc: transformToc(toc, disableHtmlExt) || {},
             ...meta,
         },
         router: {
@@ -119,6 +119,9 @@ export async function resolveMd2HTML(options: ResolverOptions): Promise<DocInner
 }
 
 function YamlFileTransformer(content: string, transformOptions: FileTransformOptions): Object {
+    const {disableHtmlExt} = ArgvService.getConfig();
+    const ext = disableHtmlExt ? '' : '.html';
+
     let data: LeadingPage | null = null;
 
     try {
@@ -136,7 +139,7 @@ function YamlFileTransformer(content: string, transformOptions: FileTransformOpt
     if (Object.prototype.hasOwnProperty.call(data, 'blocks')) {
         data = modifyValuesByKeys(data, LINK_KEYS, (link) => {
             if (isString(link) && getLinksWithContentExtersion(link)) {
-                return link.replace(/.(md|yaml)$/gmu, '.html');
+                return link.replace(/.(md|yaml)$/gmu, ext);
             }
         });
 
@@ -149,7 +152,7 @@ function YamlFileTransformer(content: string, transformOptions: FileTransformOpt
         });
     } else {
         const links = data?.links?.map((link) =>
-            link.href ? {...link, href: link.href.replace(/.md$/gmu, '.html')} : link,
+            link.href ? {...link, href: link.href.replace(/.md$/gmu, ext)} : link,
         );
 
         if (links) {
@@ -190,5 +193,6 @@ function MdFileTransformer(content: string, transformOptions: FileTransformOptio
         rootPublicPath: getAssetsRootPath(filePath),
         getVarsPerFile: getVarsPerRelativeFile,
         extractTitle: true,
+        toLinkExtention: options.disableHtmlExt ? '' : null,
     });
 }

src/steps/processPages.ts

@@ -10,6 +10,7 @@ import shell from 'shelljs';
 import {
     Lang,
     PAGE_PROCESS_CONCURRENCY,
+    REGEXP_EXT_HTML,
     ResourceType,
     SINGLE_PAGE_DATA_FILENAME,
     SINGLE_PAGE_FILENAME,
@@ -189,15 +190,18 @@ async function saveSinglePages() {
 }
 
 function saveRedirectPage(outputDir: string): void {
-    const {lang, langs} = ArgvService.getConfig();
+    const {lang, langs, disableHtmlExt} = ArgvService.getConfig();
 
     const redirectLang = lang || langs?.[0] || Lang.RU;
-    const redirectLangRelativePath = `./${redirectLang}/index.html`;
+    let redirectLangRelativePath = `./${redirectLang}/index.html`;
 
     const redirectPagePath = join(outputDir, 'index.html');
     const redirectLangPath = join(outputDir, redirectLangRelativePath);
 
     if (!existsSync(redirectPagePath) && existsSync(redirectLangPath)) {
+        if (disableHtmlExt) {
+            redirectLangRelativePath = redirectLangRelativePath.replace(REGEXP_EXT_HTML, '');
+        }
         const content = generateStaticRedirect(redirectLang, redirectLangRelativePath);
         writeFileSync(redirectPagePath, content);
     }

src/utils/toc.ts

@@ -5,7 +5,7 @@ import {filterFiles} from '../services/utils';
 import {isExternalHref} from './url';
 import {getSinglePageAnchorId} from './singlePage';
 
-export function transformToc(toc: YfmToc | null): YfmToc | null {
+export function transformToc(toc: YfmToc | null, disableHtmlExt: boolean): YfmToc | null {
     if (!toc) {
         return null;
     }
@@ -41,10 +41,12 @@ export function transformToc(toc: YfmToc | null): YfmToc | null {
         if (href && !isExternalHref(href)) {
             const fileExtension: string = extname(href);
             const filename: string = basename(href, fileExtension);
-            const transformedFilename: string = format({
-                name: filename,
-                ext: '.html',
-            });
+            const transformedFilename: string = disableHtmlExt
+                ? filename
+                : format({
+                      name: filename,
+                      ext: '.html',
+                  });
 
             navigationItem.href = join(dirname(href), transformedFilename);
         }