fusion.ssg.docs/index.html at main · 4awpawz/fusion.ssg.docs · GitHub

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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
<!DOCTYPE html>
<html lang="en" data-theme="dark">

<head>
    <!-- Google tag (gtag.js) -->
    <script async src="https://www.googletagmanager.com/gtag/js?id=G-GSTWCZHVEG"></script>
    <script>
        window.dataLayer = window.dataLayer || [];

        function gtag() {
            dataLayer.push(arguments);
        }
        gtag('js', new Date());
        gtag('config', 'G-GSTWCZHVEG');
    </script>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta name="description" content="fusion.ssg, a minimal framework for building static websites.">
    <meta name="author" content="4awpaws, Jeffrey Schwartz">
    <meta name="generator" content="fusion.ssg">
    <meta property="og:title" content="A Minimal Framework for Static Websites">
    <meta property="og:type" content="website" />
    <meta property="og:description" content="fusion.ssg propels your static website development to a whole new level!">
    <meta property="og:image" content="https://fusionssg.com/media/social/640x569-solar-energy.a00260380d40e38219a253a07a3adbd6.png">
    <meta property="og:url" content="https://fusionssg.com">
    <meta name="twitter:card" content="summary_large_image">
    <link rel="stylesheet" href="/css/libs/pico/pico.6e30cf0269b75b7793b92b74054a1f49.min.css">
    <link rel="stylesheet" href="/css/libs/highlight/github-dark.087d8559eb8f2a44491209286dac72eb.min.css">
    <link rel="stylesheet" href="/css/fusion.390b75697f4684d5eb281e74dbec8074.css">
    <script src="/scripts/libs/highlight/highlight.f2c6a6b6a19fbf520b1614f6b86fdc99.min.js"></script>
    <script>
        hljs.highlightAll();
    </script>
    <title>fusion.ssg: Minimal Framework for Building Static Websites</title>
</head>

<body class="homepage">
    <nav class="container-fluid topnav">
        <ul>
            <li><a class="contrast fixed" href="/"><img id="navbar-sol" src="/media/sol.e57b7b50ce9cd0011ddacf3f0203f63b.png" alt="sol" /></a></li>
            <li><a class="contrast fixed" href="/"><strong>fusion.ssg</strong></a></li>
        </ul>
        <ul>
            <li><a id="navbar-examples" class="secondary" href="/#examples">Examples</a></li>
            <li><a class="secondary" href="/docs/v1/gettingstarted">Docs</a></li>
            <li><a class="secondary" href="/news">News</a></li>
            <li><a aria-label="fusion.ssg Github Repositroy" href="https://github.com/4awpawz/fusion.ssg"><svg id="navbar-github" aria-hidden="true" focusable="false" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512" height="16px">
                        <path fill="currentColor" d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"></path>
                    </svg></a></li>
        </ul>
    </nav>
    <header class="hero">
        <div class="container">
            <a href="/news/release/v1/2024/11/21/v1.3.0/" class="hero-button hero-version" role="button" aria-label="what's new">New in v1.3.0</a>
            <hgroup>
                <h1>The web framework for static content-driven websites</h1>
                <p>fusion.ssg seamlessly fuses together familiar web-based technologies to propel your static website development to a whole new level.</p>
            </hgroup>
            <div class="button-group">
                <a href="/docs/v1/gettingstarted" class="hero-button hero-get-started" role="button" aria-label="get started">Get Started</a>
                <a href="/docs/v1/gettingstarted/installation" class="hero-button hero-install-now" role="button" aria-label="install now">Install Now</a>
            </div>
            <div class="hero-familiar-technologies"><code>HTML</code><code>Markdown</code><code>Front Matter</code><code>JSX/TSX</code><code>JSON</code>
            </div>
        </div>
    </header>
    <main>
        <section class="container">
            <div class="why-fusion">
                <header>
                    <h2>Create resilient static websites</h2>
                </header>
                <section class="grid">
                    <article>
                        <hgroup>
                            <h3><img src="/media/plato-64.12e0b26b972eadf3beb2f1ab78dfc1a6.png" alt="Plato">Philosophy</h3>
                            <p>The most useful tools are those that fully embrace the functionality that directly reflects their purpose and ignores all others.</p>
                        </hgroup>
                    </article>
                    <article>
                        <hgroup>
                            <h3><img src="/media/tiny-64.7aabbd6e2823369b57d7a61d9d0a9af8.png" alt="Home">Minimalistic</h3>
                            <p>fusion.ssg is built from the ground up to be just that, making it quick to learn for anyone who already has experience with HTML, JavaScript and CSS.</p>
                        </hgroup>
                    </article>
                </section>
                <section class="grid">
                    <article>
                        <hgroup>
                            <h3><img src="/media/clock-64.c19c45c2bedd72a8d28bd296d773c74f.png" alt="Home">Productivity</h3>
                            <p> No complicated tooling and configuration to stand in the way of your creativity, and the project generator gets you up and creating quickly.</p>
                        </hgroup>
                    </article>
                    <article>
                        <hgroup>
                            <h3><img src="/media/rocket.460415635ddbe1e833cd16a4581ae72f.png" alt="Home">Really&nbsp;Fast</h3>
                            <p>Capable of generating 100s of HTML documents in under a second.</p>
                        </hgroup>
                    </article>
                </section>
            </div>
            <div class="features">
                <header>
                    <h2>Features</h2>
                </header>
                <article>
                    <ul>
                        <li>Easily create new projects (*** batteries included ***).</li>
                        <li>Zero initial project configuration.</li>
                        <li>DOMless and serverless for really fast site generation.</li>
                        <li>Component compilation and sand-boxed execution.</li>
                        <li>Bulk HTML document generation.</li>
                        <li>Fully scripted development and release builds.</li>
                        <li>Beautified HTML and CSS documents.</li>
                        <li>Cache busting for release builds (optional).</li>
                        <li>Blog posts, tags and categories support.</li>
                        <li>Works In Progress (WIPS) support.</li>
                        <li>Base URL support for sites hosted in sub folders.</li>
                        <li>Informative metrics reporting after every build cycle.</li>
                    </ul>
                </article>
            </div>
            <div id="examples" class="examples">
                <header>
                    <h2>Examples</h2>
                </header>
                <article>
                    <header>
                        <h3>HTML Document<br>From A Template And A Page</h3>
                    </header>
                    <h4 id="template-with-token-value-declarations">Template with token value declarations</h4>
                    <pre><code class="language-html">---
tokens: {
    pageTitle: Greetings,
    greeting: Hello World
}
---
</code></pre>
                    <h4 id="page-using-tokens">Page using tokens</h4>
                    <pre><code class="language-html">&lt;!DOCTYPE html&gt;
&lt;html lang=&quot;en&quot;&gt;
    &lt;head&gt;
        &lt;meta charset=&quot;UTF-8&quot;&gt;
        &lt;meta http-equiv=&quot;X-UA-Compatible&quot; content=&quot;IE=edge&quot;&gt;
        &lt;meta name=&quot;viewport&quot; content=&quot;width=device-width, initial-scale=1.0&quot;&gt;
        &lt;title&gt;{pageTitle}&lt;/title&gt;
    &lt;/head&gt;
    &lt;body&gt;
        &lt;main&gt;
            &lt;h1&gt;{greeting}&lt;/h1&gt;
        &lt;/main&gt;
    &lt;/body&gt;
&lt;/html&gt;
</code></pre>
                    <h4 id="generated-html-document">Generated HTML document</h4>
                    <pre><code class="language-html">&lt;!DOCTYPE html&gt;
&lt;html lang=&quot;en&quot;&gt;
    &lt;head&gt;
        &lt;meta charset=&quot;UTF-8&quot;&gt;
        &lt;meta http-equiv=&quot;X-UA-Compatible&quot; content=&quot;IE=edge&quot;&gt;
        &lt;meta name=&quot;viewport&quot; content=&quot;width=device-width, initial-scale=1.0&quot;&gt;
        &lt;title&gt;Greetings&lt;/title&gt;
    &lt;/head&gt;
    &lt;body&gt;
        &lt;main&gt;
            &lt;h1&gt;Hello World&lt;/h1&gt;
        &lt;/main&gt;
    &lt;/body&gt;
&lt;/html&gt;
</code></pre>
                </article>
                <article>
                    <header>
                        <h3>HTML Document<br>With A List<br>From A Component And JSON</h3>
                    </header>
                    <h4 id="teamjson-data-source">team.json data source</h4>
                    <pre><code class="language-json">[
{&quot;name&quot;: { &quot;first&quot;: &quot;John&quot;, &quot;last&quot;: &quot;Doe&quot; }},
{&quot;name&quot;: { &quot;first&quot;: &quot;Jane&quot;, &quot;last&quot;: &quot;Doe&quot; }},
{&quot;name&quot;: { &quot;first&quot;: &quot;Julia&quot;, &quot;last&quot;: &quot;Doe&quot; }}
]
</code></pre>
                    <h4 id="template-with-teammembers-component">Template with TeamMembers component</h4>
                    <pre><code class="language-html">---
tokens: {
    pageTitle: Team Members
}
---
&lt;h1&gt;Team&lt;/h1&gt;
&lt;p&gt;Thanks to our team our rollout has been a huge success.&lt;/p&gt;
&lt;h2&gt;Contributors&lt;/h2&gt;
&lt;TeamMembers datasources=&quot;team.json&quot; /&gt;
</code></pre>
                    <h4 id="teammembersjsx-component">TeamMembers.jsx component</h4>
                    <pre><code class="language-javascript">function formatName(member) {
    return `${member.name.first} ${member.name.last}`;
}

export const TeamMembers = function({ team }) {
    return (
        &lt;ul&gt;
            {team.map(member =&gt; {
                return &lt;li&gt;
                    &lt;p&gt;&lt;{formatName(member)}&lt;/p&gt;
                &lt;/li&gt;;
            })}
        &lt;/ul&gt;
    );
};
</code></pre>
                    <h4 id="teammemberstsx-component">TeamMembers.tsx component</h4>
                    <pre><code class="language-typescript">interface TeamMember {
    &quot;name&quot;: {
        &quot;first&quot;: string,
        &quot;last&quot;: string
    }
}

interface Props {
    team: TeamMember[]
}

function formatName(member: TeamMember): string {
    return `${member.name.first} ${member.name.last}`;
}

export const TeamMembers = function({ team }: Props): string {
    return (
        &lt;ul&gt;
            {team.map(member =&gt; {
                return &lt;li&gt;
                    &lt;p&gt;&lt;{formatName(member)}&lt;/p&gt;
                &lt;/li&gt;;
            })}
        &lt;/ul&gt;
    );
};
</code></pre>
                    <h4 id="page">Page</h4>
                    <pre><code class="language-html">&lt;!DOCTYPE html&gt;
&lt;html lang=&quot;en&quot;&gt;
&lt;head&gt;
    &lt;meta charset=&quot;UTF-8&quot;&gt;
    &lt;meta http-equiv=&quot;X-UA-Compatible&quot; content=&quot;IE=edge&quot;&gt;
    &lt;meta name=&quot;viewport&quot; content=&quot;width=device-width, initial-scale=1.0&quot;&gt;
    &lt;title&gt;{pageTitle}&lt;/title&gt;
&lt;/head&gt;
&lt;body&gt;
    &lt;main&gt;
        {{template}}
    &lt;/main&gt;
&lt;/body&gt;
&lt;/html&gt;
</code></pre>
                    <h4 id="generated-html-document">Generated HTML document</h4>
                    <pre><code class="language-html">&lt;html lang=&quot;en&quot;&gt;
&lt;head&gt;
    &lt;meta charset=&quot;UTF-8&quot;&gt;
    &lt;meta http-equiv=&quot;X-UA-Compatible&quot; content=&quot;IE=edge&quot;&gt;
    &lt;meta name=&quot;viewport&quot; content=&quot;width=device-width, initial-scale=1.0&quot;&gt;
    &lt;title&gt;Team Members&lt;/title&gt;
&lt;/head&gt;
&lt;body&gt;
    &lt;main&gt;
        &lt;h1&gt;Team&lt;/h1&gt;
        &lt;p&gt;Thanks to our team our rollout has been a huge success.&lt;/p&gt;
        &lt;h2&gt;Contributors&lt;/h2&gt;
        &lt;ul&gt;
            &lt;li&gt;&lt;p&gt;John Doe&lt;/p&gt;&lt;/li&gt;
            &lt;li&gt;&lt;p&gt;Jane Doe&lt;/p&gt;&lt;/li&gt;
            &lt;li&gt;&lt;p&gt;Julia Doe&lt;/p&gt;&lt;/li&gt;
        &lt;/ul&gt;
    &lt;/main&gt;
&lt;/body&gt;
&lt;/html&gt;
</code></pre>
                </article>
            </div>
            <div class="show-appreciation">
                <script async defer src="https://buttons.github.io/buttons.js"></script>
                <header>
                    <h2>Show Your Appreciation</h2>
                </header>
                <p><a href="https://www.buymeacoffee.com/4awpawz"><img src="/media/buymeacoffee.8a218f5996c7bc480d87d13b6b464135.png" alt="image"></a></p>
                <p><a class="github-button" href="https://github.com/4awpawz/fusion.ssg" data-color-scheme="no-preference: light; light: light; dark: dark;" data-icon="octicon-star" data-size="large" data-show-count="true" aria-label="Star 4awpawz/fusion.ssg on GitHub">Give us a star on GitHub</a></p>
                <p><a class="github-button" href="https://github.com/4awpawz/fusion.ssg/subscription" data-color-scheme="no-preference: light; light: light; dark: dark;" data-icon="octicon-eye" data-size="large" data-show-count="true" aria-label="Watch 4awpawz/fusion.ssg on GitHub">Watch</a>
                </p>
            </div>
        </section>
    </main>
    <footer class="container site-footer">
        <div class="site-footer-column">
            <div class="site-footer-column-heading">Site</div>
            <div class="site-footer-column-item"><a href="/docs">Docs</a></div>
            <div class="site-footer-column-item"><a href="/development">Development</a></div>
            <div class="site-footer-column-item">
                <a href="https://github.com/4awpawz/fusion.ssg.web/blob/main/CHANGELOG.txt">Changelog</a>
            </div>
        </div>
        <div class="site-footer-column">
            <div class="site-footer-column-heading">Social</div>
            <div class="site-footer-column-item"><a href="https://github.com/4awpawz/fusion.ssg">GitHub</a></div>
            <div class="site-footer-column-item"><a href="https://twitter.com/4awpawz">Twitter</a></div>
            <div class="site-footer-column-item"><a href="https://www.youtube.com/channel/UCzGhKoH-7wbNoFY_adCYvnA">YouTube</a>
            </div>
        </div>
        <div class="site-footer-column">
            <div class="site-footer-column-heading">Attribution</div>
            <div class="site-footer-column-item">Created by Jeffrey Schwartz</div>
            <div class="site-footer-column-item">Code licensed MIT</div>
            <div class="site-footer-column-item">This site was built using fusion.ssg v1.3.0</div>
        </div>
    </footer>
</body>

</html>