import fs from 'fs' import matter from 'gray-matter' import path from 'path' import { Article, ArticleStatus, Articles, Category, InputSection, Section, } from '../../types/content-types' import { CONTENT_DIR } from '../utils' export function generateSection(section: InputSection, articles: Articles, index: number): Section { // Uncategorized articles const _ucg: Article[] = [] // A temporary table of articles mapped to categories const _categoryArticles: Record = Object.fromEntries( section.categories.map((category) => [category.id, []]) ) // The file directory for this section const dir = path.join(CONTENT_DIR, section.id) const files = fs.readdirSync(dir, { withFileTypes: false }) const isGenerated = section.id === 'gen' for (const file of files) { const filename = file.toString() const fileContent = fs.readFileSync(path.join(dir, filename)).toString() const extension = path.extname(filename) const articleId = filename.replace(extension, '') const parsed = matter({ content: fileContent }, {}) // If we're in prod and the article isn't published, skip it if (process.env.NODE_ENV !== 'development' && parsed.data.status !== 'published') { continue } // If a category was provided but that category was not found in the section, throw an error const category = parsed.data.category && section.categories.find((c) => c.id === parsed.data.category) // By default, the category is ucg (uncategorized, with the section id in the id) const { category: categoryId = section.id + '_ucg', author = 'api' } = parsed.data const isUncategorized = categoryId === section.id + '_ucg' const isIndex = articleId === section.id const article: Article = { id: articleId, type: 'article', sectionIndex: 0, groupIndex: -1, groupId: parsed.data.group ?? null, categoryIndex: parsed.data.order ?? -1, sectionId: section.id, author, categoryId, status: parsed.data.status ?? ArticleStatus.Draft, title: parsed.data.title ?? 'Untitled article', description: parsed.data.description, hero: parsed.data.hero ?? null, date: parsed.data.date ? new Date(parsed.data.date).toISOString() : null, keywords: parsed.data.keywords ?? [], sourceUrl: isGenerated // if it's a generated API doc, then we don't have a link ? parsed.data.sourceUrl ?? null : `${section.id}/${articleId}${extension}`, content: parsed.content, path: section.id === 'getting-started' ? `/${articleId}` : isUncategorized ? `/${section.id}/${articleId}` : `/${section.id}/${categoryId}/${articleId}`, } if (isIndex) { article.categoryIndex = -1 article.sectionIndex = -1 articles[section.id + '_index'] = article } else { if (category) { if (article.id === category.id) { article.categoryIndex = -1 article.sectionIndex = -1 articles[category.id + '_index'] = article } else { _categoryArticles[categoryId].push(article) } } else { _ucg.push(article) } } } let sectionIndex = 0 // Sort ucg articles by date and add them to the articles table _ucg.sort(sortArticles).forEach((article, i) => { article.categoryIndex = i article.sectionIndex = sectionIndex articles[article.id] = article sectionIndex++ }) const categories: Category[] = [ { id: section.id + '_ucg', type: 'category', sectionId: section.id, index: 0, title: 'Uncategorized', description: 'Articles that do not belong to a category.', groups: [], path: `/${section.id}/ucg`, content: null, }, ] // Sort categorized articles by date and add them to the articles table section.categories.forEach((inputCategory, i) => { const categoryArticles = _categoryArticles[inputCategory.id] categoryArticles.sort(sortArticles).forEach((article, i) => { article.categoryIndex = i article.sectionIndex = sectionIndex articles[article.id] = article sectionIndex++ }) if (categoryArticles.length) { categories.push({ ...inputCategory, type: 'category', sectionId: section.id, index: i + 1, path: `/${section.id}/${inputCategory.id}`, content: null, groups: inputCategory.groups.map(({ id }, i) => ({ id, title: id, index: i, type: 'group', sectionId: section.id, categoryId: inputCategory.id, description: null, content: null, path: `/${section.id}/${inputCategory.id}/${id}`, })), }) } }) return { ...section, type: 'section', sidebar_behavior: section.sidebar_behavior, index, categories, content: '', path: `/${section.id}`, } } const sortArticles = (articleA: Article, articleB: Article) => { const { categoryIndex: categoryIndexA, date: dateA = '01/01/1970' } = articleA const { categoryIndex: categoryIndexB, date: dateB = '01/01/1970' } = articleB return categoryIndexA === categoryIndexB ? new Date(dateB!).getTime() > new Date(dateA!).getTime() ? 1 : -1 : categoryIndexA < categoryIndexB ? -1 : 1 }