mirror of
https://github.com/facebook/docusaurus.git
synced 2025-06-07 05:12:31 +02:00
* docs i18n initial poc * docs i18n initial poc * docs i18n initial poc * docs i18n initial poc * crowdin-v2 attempt * fix source * use crowdin env variable * try to install crowdin on netlify * try to install crowdin on netlify * try to use crowdin jar directly * try to curl the crowdin jar * add java version cmd * try to run crowdin jar in netlify * fix translatedDocsDirPath * fix loadContext issue due to site baseUrl not being modified in generted config file * real validateLocalesFile * add locale option to deploy command * better LocalizationFile type * create util getPluginI18nPath * better core localization context loading code * More explicit VersionMetadata type for localized docs folders * Ability to translate blog posts with Crowdin! * blog: refactor markdown loader + report broken links + try to get linkify working better * upgrade crowdin config to upload all docs folder files except source code related files * try to support translated pages * make markdown pages translation work * add write-translations cli command template * fix site not reloaded with correct options * refactor a bit the read/write of @generated/i18n.json file * Add <Translate> + translate() API + use it on the docusaurus homepage * watch locale translation dir * early POC of adding babel parsing for translation extraction * fs.stat => pathExists * add install:fast script * TSC: noUnusedLocals false as it's already checked by eslint * POC of extracting translations from source code * minor typo * fix extracted key to code * initial docs extracted translations * stable plugin translations POC * add crowdin commands * quickfix for i18n deployment * POC of themeConfig translation * add ability to have localized site without path prefix * sidebar typo * refactor translation system to output multiple translation files * translate properly the docs plugin * improve theme classic translation * rework translation extractor to handle new Chrome I18n JSON format (include id/description) * writeTranslations: allow to pass locales cli arg * fix ThemeConfig TS issues * fix localizePath errors * temporary add write-translations to netlify deploy preview * complete example of french translated folder * update fr folder * remove all translations from repo * minor translation refactors * fix all docs-related tests * fix blog feed tests * fix last blog tests * refactor i18n context a bit, extract codeTranslations in an extra generated file * improve @generated/i18n type * fix some i18n todos * minor refactor * fix logo typing issue after merge * move i18n.json to siteConfig instead * try to fix windows CI build * fix config test * attempt to fix windows non-posix path * increase v1 minify css jest timeout due to flaky test * proper support for localizePath on windows * remove non-functional install:fast * docs, fix docsDirPathLocalized * fix Docs i18n / md linkify issues * ensure theme-classic swizzling will use "nextjs" sources (transpiled less aggressively, to make them human readable) * fix some snapshots * improve themeConfig translation code * refactor a bit getPluginI18nPath * readTranslationFileContent => ensure files are valid, fail fast * fix versions tests * add extractSourceCodeAstTranslations comments/resource links * ignore eslint: packages/docusaurus-theme-classic/lib-next/ * fix windows CI with cross-env * crowdin ignore .DS_Store * improve writeTranslations + add exhaustive tests for translations.ts * remove typo * Wire currentLocale to algolia search * improve i18n locale error * Add tests for translationsExtractor.ts * better code translation extraction regarding statically evaluable code * fix typo * fix typo * improve theme-classic transpilation * refactor + add i18n tests * typo * test new utils * add missing snapshots * fix snapshot * blog onBrokenMarkdownLink * add sidebars tests * theme-classic index should now use ES modules * tests for theme-classic translations * useless comment * add more translation tests * simplify/cleanup writeTranslations * try to fix Netlify fr deployment * blog: test translated md is used during feed generation * blog: better i18n tests regarding editUrl + md translation application * more i18n tests for docs plugin * more i18n tests for docs plugin * Add tests for pages i18n * polish docusaurus build i18n logs
110 lines
3.7 KiB
JavaScript
110 lines
3.7 KiB
JavaScript
/**
|
|
* Copyright (c) Facebook, Inc. and its affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*/
|
|
const path = require('path');
|
|
const fs = require('fs');
|
|
const utils = require('../utils');
|
|
|
|
jest.mock('../env', () => ({
|
|
translation: {
|
|
enabled: true,
|
|
enabledLanguages: () => [
|
|
{
|
|
enabled: true,
|
|
name: 'English',
|
|
tag: 'en',
|
|
},
|
|
{
|
|
enabled: true,
|
|
name: '日本語',
|
|
tag: 'ja',
|
|
},
|
|
],
|
|
},
|
|
}));
|
|
|
|
describe('server utils', () => {
|
|
test('minify css', async () => {
|
|
const testCss = fs.readFileSync(
|
|
path.join(__dirname, '__fixtures__', 'test.css'),
|
|
'utf8',
|
|
);
|
|
const notCss = fs.readFileSync(
|
|
path.join(__dirname, '__fixtures__', 'test.md'),
|
|
'utf8',
|
|
);
|
|
const css = await utils.minifyCss(testCss);
|
|
expect(css).toMatchSnapshot();
|
|
|
|
await expect(utils.minifyCss(notCss)).rejects.toMatchSnapshot();
|
|
}, 10000);
|
|
|
|
test('autoprefix css', async () => {
|
|
const testCss = fs.readFileSync(
|
|
path.join(__dirname, '__fixtures__', 'test.css'),
|
|
'utf8',
|
|
);
|
|
|
|
const css = await utils.autoPrefixCss(testCss);
|
|
expect(css).toMatchSnapshot();
|
|
});
|
|
|
|
test('getLanguage', () => {
|
|
const testDocEnglish = path.join('translated_docs', 'en', 'test.md');
|
|
const testDocJapanese = path.join('translated_docs', 'ja', 'test.md');
|
|
const testDocJapaneseInSubfolder = path.join(
|
|
'translated_docs',
|
|
'ja',
|
|
'en',
|
|
'test.md',
|
|
);
|
|
const testDocInSubfolder = path.join('docs', 'ro', 'test.md');
|
|
const testDocNoLanguage = path.join('docs', 'test.md');
|
|
expect(utils.getLanguage(testDocEnglish, 'translated_docs')).toBe('en');
|
|
expect(utils.getLanguage(testDocJapanese, 'translated_docs')).toBe('ja');
|
|
expect(
|
|
utils.getLanguage(testDocJapaneseInSubfolder, 'translated_docs'),
|
|
).toBe('ja');
|
|
expect(utils.getLanguage(testDocInSubfolder, 'docs')).toBeNull();
|
|
expect(utils.getLanguage(testDocNoLanguage, 'docs')).toBeNull();
|
|
});
|
|
|
|
test('getSubdir', () => {
|
|
const docA = path.join('docs', 'endiliey', 'a.md');
|
|
const docB = path.join('docs', 'nus', 'hackers', 'b.md');
|
|
const docC = path.join('docs', 'c.md');
|
|
const docD = path.join('website', 'translated_docs', 'wow', 'd.md');
|
|
const docE = path.join('website', 'translated_docs', 'lol', 'lah', 'e.md');
|
|
const docsDir = path.join('docs');
|
|
const translatedDir = path.join('website', 'translated_docs');
|
|
expect(utils.getSubDir(docA, docsDir)).toEqual('endiliey');
|
|
expect(utils.getSubDir(docA, translatedDir)).toBeNull();
|
|
expect(utils.getSubDir(docB, docsDir)).toEqual('nus/hackers');
|
|
expect(utils.getSubDir(docB, translatedDir)).toBeNull();
|
|
expect(utils.getSubDir(docC, docsDir)).toBeNull();
|
|
expect(utils.getSubDir(docC, translatedDir)).toBeNull();
|
|
expect(utils.getSubDir(docD, docsDir)).toBeNull();
|
|
expect(utils.getSubDir(docD, translatedDir)).toEqual('wow');
|
|
expect(utils.getSubDir(docE, docsDir)).toBeNull();
|
|
expect(utils.getSubDir(docE, translatedDir)).toEqual('lol/lah');
|
|
});
|
|
|
|
describe('replaceAssetsLink', () => {
|
|
test('verifies asset link is replaced after code block', () => {
|
|
const content = '```Some block```\n more text';
|
|
const link = utils.replaceAssetsLink(content, 'thelocation');
|
|
expect(link).toBe(
|
|
'```Some block```\n more text',
|
|
);
|
|
});
|
|
|
|
test('verifies asset link is not replaced inside a fenced code block', () => {
|
|
const content = '```\n\n```';
|
|
const link = utils.replaceAssetsLink(content, 'thelocation');
|
|
expect(link).toBe('```\n\n```');
|
|
});
|
|
});
|
|
});
|