Batch & Axcora X - Static Site Generator v1.0
Read Docs: https://bax.axcora.com
If you find BAX helpful, consider supporting us:
Your support helps us maintain and improve BAX! ❤️
- Features
- Quick Start
- Installation
- Configuration
- Content Creation
- SEO Features
- Directory Structure
- CSS Customization
- Commands
- Deployment
- Contributing
- License
- Support & Donation
- ⚡ Lightning Fast - Pure Batch/Bash, no dependencies
- 🎨 Modern Design - Bootstrap 5 with custom elegant CSS
- 📱 Fully Responsive - Looks great on all devices
- 🔍 SEO Optimized - Meta tags, Open Graph, Twitter Cards
- 📝 Markdown-like - Simple
.zetfile format - 🏷️ Tag Support - Auto-generate tag pages
- 📄 Pagination - Built-in post pagination
- 🗺️ Sitemap Ready - Clean URL structure
- 🌐 Cross-platform - Windows (
.bat) & Linux/Mac (.sh) - 🎯 User-friendly - Simple configuration file
- 🚀 Production Ready - Deploy anywhere
Run Build
bax.batchmod +x bax.sh
./bax.shRun Dev Mode
run.batchmod +x run.sh
./run.shgit clone https://github.com/mesinkasir/bax.git
cd baxbax/
├── bax.bat # Windows build script
├── bax.sh # Linux/Mac build script
├── run.bat # Windows dev script
├── run.sh # Linux/Mac dev script
├── config.zet # Site configuration
├── style.css # Custom styles
├── data/ # Blog posts
│ └── *.zet
├── pages/ # Static pages
│ └── *.zet
└── public/ # Generated output (auto-created)
├── index.html
├── pages/
├── tags/
└── *.html
Create config.zet in your project root:
SITE_TITLE:Axcora Zetta Core
SITE_URL:https://axcora.my.id
SITE_DESCRIPTION:Modern static site generator built with Batch
SITE_IMAGE:https://axcora.com/default-og.jpg
SITE_FAVICON:/favicon.ico
POSTS_PER_PAGE:6
NAV:
- text: Home
url: /
- text: About
url: /about
- text: Portfolio
url: /portfolio
- text: Contact
url: /contact| Option | Description | Required |
|---|---|---|
SITE_TITLE |
Site title (used in navbar & SEO) | ✅ |
SITE_URL |
Site URL (with or without trailing slash) | ✅ |
SITE_DESCRIPTION |
Site description for SEO | ❌ |
SITE_IMAGE |
Default OG image for social sharing | ❌ |
SITE_FAVICON |
Path to favicon | ❌ |
POSTS_PER_PAGE |
Number of posts per page | ❌ (default: 6) |
NAV |
Navigation menu items | ❌ |
Create .zet files in data/ folder:
File: data/my-first-post.zet
TITLE:My First Blog Post
DATE:15 July 2026
IMG:https://picsum.photos/seed/hello/600/400
DESC:This is an amazing first post about something interesting
TAGS:technology programming tutorial
P:Welcome to my first blog post! Today we're going to learn about...
P:This is another paragraph with more content.
P:You can add as many paragraphs as you want!Complete Content example
TITLE:Rich Content Example
DATE:15 July 2026
IMG:https://picsum.photos/seed/rich/1200/600
DESC:This post shows all rich content features
H2:Heading 2 - Section Title
P:This is a paragraph after heading 2.
H3:Heading 3 - Sub Section
P:Another paragraph with some content.
TABLE:
THEAD:
TR:
TH:No
TH:Name
TH:Email
/TR:
/THEAD:
TBODY:
TR:
TD:1
TD:John Doe
TD:[email protected]
/TR:
TR:
TD:2
TD:Jane Smith
TD:[email protected]
/TR:
/TBODY:
/TABLE:
H4:Heading 4 - Smaller Section
P:This is a paragraph.
BLOCKQUOTE:This is a blockquote with important information.
UL:
LI:Item one
LI:Item two
LI:Item three
/UL:
CODE:console.log("Hello World!");
TAGS:technology programming tutorial
Post Fields:
| Field | Description | Required |
|---|---|---|
TITLE |
Post title | ✅ |
DATE |
Publication date | ❌ |
IMG |
Featured image URL | ❌ |
DESC |
Post description/excerpt | ❌ |
TAGS |
Space-separated tags | ❌ |
P |
Paragraph content | ❌ |
Create .zet files in pages/ folder:
File: pages/about.zet
TITLE:About Us
DESC:Learn more about our team
IMG:https://picsum.photos/seed/about/1200/400
P:We are a team of passionate developers...
P:Our mission is to make the web better.Page Fields:
| Field | Description | Required |
|---|---|---|
TITLE |
Page title | ✅ |
DESC |
Page description | ❌ |
IMG |
Page image | ❌ |
URL |
Custom page URL | ❌ |
P |
Paragraph content | ❌ |
Add navigation items in config.zet:
NAV:
- text: Home
url: /
- text: Blog
url: /blog
- text: About
url: /about
- text: Contact
url: /contactBAX automatically generates SEO-friendly meta tags:
<!-- Basic Meta -->
<title>Page Title - Site Title</title>
<meta name="description" content="Page description">
<!-- Open Graph (Facebook, LinkedIn) -->
<meta property="og:type" content="website|article">
<meta property="og:title" content="Page Title">
<meta property="og:description" content="Page description">
<meta property="og:image" content="https://axcora.com/image.jpg">
<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Page Title">
<meta name="twitter:description" content="Page description">
<meta name="twitter:image" content="https://axcora.com/image.jpg">
<!-- Generator -->
<meta name="generator" content="BAX v1.0 - Static Site Generator by Axcora Tech">
<!-- Favicon -->
<link rel="icon" href="/favicon.ico">BAX uses a priority system for SEO metadata:
- Post/Page specific (highest priority)
- Site-wide config (fallback)
- Default values (last resort)
After build, your public/ folder will contain:
public/
├── index.html # Homepage
├── page-2.html # Page 2
├── page-3.html # Page 3
├── style.css # Compiled CSS
├── sitemap.xml # Sitemap
├── robots.txt # Robots file
├── pages/ # Static pages
│ ├── about.html
│ ├── portfolio.html
│ └── contact.html
├── tags/ # Tag pages
│ ├── technology.html
│ ├── programming.html
│ └── tutorial.html
├── my-first-post.html # Post 1
├── another-post.html # Post 2
└── ...
BAX comes with a beautiful, modern CSS design featuring:
- 🎯 Clean typography with Inter font
- 🌈 Gradient accents (primary blue to purple)
- 💨 Smooth animations and transitions
- 📱 Fully responsive layout
- ✨ Glass-morphism navbar
- 🖼️ Image hover effects
- 🏷️ Styled tags and buttons
Edit style.css in your project root:
/* Change primary color */
.btn-primary {
background: linear-gradient(135deg, #your-color, #your-color2) !important;
}
/* Change font */
body {
font-family: 'Your Font', sans-serif;
}
/* Customize card design */
.post-card {
border-radius: 20px;
/* your styles */
}bax.batchmod +x bax.sh
./bax.sh# Windows
rmdir /s /q public
bax.bat
# Linux/macOS
rm -rf public
./bax.sh- Rename
deploy.yml.exampletodeploy.yml:
mv .github/workflows/deploy.yml.example .github/workflows/deploy.yml- Push to GitHub:
git add .
git commit -m "Deploy to GitHub Pages"
git push origin main- Enable GitHub Pages in repository Settings → Pages → Source: GitHub Actions
# Set build command
./bax.sh
# Set publish directory
public/# Set build command
./bax.sh
# Set output directory
public/# Set build command
./bax.sh
# Set build output
public/We welcome contributions! Here's how:
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- Keep it simple and clean
- Maintain cross-platform compatibility
- Update documentation
- Test on both Windows and Linux
This project is licensed under the MIT License - see the LICENSE file for details.
If you find BAX helpful, consider supporting us:
Your support helps us maintain and improve BAX! ❤️
- Built with ❤️ by Axcora Tech
- Powered by Bootstrap 5
Made with ❤️ by Axcora Tech
BAX - Because Static Sites Should Be Simple! 🚀
