1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
#!/usr/bin/env node
/**
* Script to build toml++ documentation using Poxy
* This generates HTML documentation from the Doxygen-formatted markdown files
*/
import { execSync } from 'child_process';
import { existsSync, mkdirSync } from 'fs';
import { join, dirname } from 'path';
import { fileURLToPath } from 'url';
const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);
const projectRoot = join(__dirname, '..');
const colors = {
reset: '\x1b[0m',
green: '\x1b[32m',
yellow: '\x1b[33m',
red: '\x1b[31m',
blue: '\x1b[34m',
};
function log(message, color = colors.reset) {
console.log(`${color}${message}${colors.reset}`);
}
function commandExists(command) {
try {
execSync(`which ${command}`, { stdio: 'ignore' });
return true;
} catch {
return false;
}
}
async function buildTomlPlusPlusDocs() {
log('\nšØ Building toml++ documentation...', colors.blue);
// Check if dependencies exist
if (!commandExists('doxygen')) {
log('ā Doxygen is not installed!', colors.red);
log('Run: npm run setup:doxygen', colors.yellow);
process.exit(1);
}
// Check for poxy in common locations
const poxyPaths = [
'poxy',
`${process.env.HOME}/.local/bin/poxy`,
];
let poxyCommand = null;
for (const path of poxyPaths) {
if (commandExists(path)) {
poxyCommand = path;
break;
}
}
if (!poxyCommand) {
log('ā Poxy is not installed or not in PATH!', colors.red);
log('Run: npm run setup:doxygen', colors.yellow);
log('Or add to PATH: export PATH="$HOME/.local/bin:$PATH"', colors.yellow);
process.exit(1);
}
const tomlplusplusDir = join(projectRoot, 'website', 'tomlplusplus');
if (!existsSync(tomlplusplusDir)) {
log(`ā toml++ source directory not found: ${tomlplusplusDir}`, colors.red);
process.exit(1);
}
try {
log('š Running Poxy to generate documentation...', colors.yellow);
// Change to tomlplusplus directory and run poxy
process.chdir(tomlplusplusDir);
// Run poxy - it will use the poxy.toml config file
// Fix PATH to use Homebrew Python instead of Nix Python (if present)
const fixedPath = `/opt/homebrew/bin:${process.env.HOME}/.local/bin:${process.env.PATH}`;
execSync(poxyCommand, {
stdio: 'inherit',
env: { ...process.env, PATH: fixedPath }
});
const outputDir = join(tomlplusplusDir, 'html');
log('ā
toml++ documentation built successfully!', colors.green);
log(`š Output: ${outputDir}`, colors.blue);
log('š Will be copied to: _site/tomlplusplus/', colors.blue);
} catch (error) {
log(`ā Failed to build documentation: ${error.message}`, colors.red);
log('\nš” Tips:', colors.yellow);
log(' - Make sure poxy.toml exists in website/tomlplusplus/', colors.yellow);
log(' - Check that all source files are present', colors.yellow);
log(' - Try running manually: cd website/tomlplusplus && poxy', colors.yellow);
process.exit(1);
} finally {
// Return to project root
process.chdir(projectRoot);
}
}
buildTomlPlusPlusDocs().catch(error => {
log(`\nā Unexpected error: ${error.message}`, colors.red);
process.exit(1);
});
|
