commit c5bbac5
Artur Manuel
·
2026-05-31 20:44:55 +0000 UTC
parent 360bccd
ci: reintroduce codeberg pages deployment ci
16 files changed,
+1188,
-0
+30,
-0
1@@ -0,0 +1,30 @@
2+name: Build and deploy pages
3+on:
4+ push:
5+ branches:
6+ - main
7+jobs:
8+ build-glerc:
9+ runs-on: codeberg-small-lazy
10+ steps:
11+ - name: Checkout repository
12+ uses: https://data.forgejo.org/actions/checkout@v6
13+ with:
14+ ref: "main"
15+ submodules: true
16+ - name: Setup Go
17+ working-directory: ./glerc
18+ uses: https://data.forgejo.org/actions/setup-go@v6
19+ with:
20+ go-version-file: go.mod
21+ - name: Build glerc
22+ working-directory: ./glerc
23+ run: make
24+ - name: Build pages
25+ run: ./glerc/glerc
26+ - name: Deploy pages
27+ uses: https://codeberg.org/git-pages/action@v2
28+ with:
29+ site: 'https://${{ forge.repository_owner }}.codeberg.page'
30+ token: ${{ forge.token }}
31+ source: output/
+2,
-0
1@@ -1,4 +1,5 @@
2 **
3+!/glerc
4 !/cmd
5 !/cmd/**
6 !/pkg
7@@ -13,6 +14,7 @@
8 !/assets/**
9 !/.gitignore
10 !/.editorconfig
11+!/.gitmodules
12 !/Makefile
13 !/README.md
14 !/LICENSE
+3,
-0
1@@ -0,0 +1,3 @@
2+[submodule ".forgejo/workflows/glerc"]
3+ path = .forgejo/workflows/glerc
4+ url = https://codeberg.org/dani-institute/glerc.git
+7,
-0
1@@ -0,0 +1,7 @@
2+[*.go]
3+indent_style = tab
4+indent_size = 8
5+
6+[Makefile]
7+indent_style = tab
8+indent_size = 8
+13,
-0
1@@ -0,0 +1,13 @@
2+**
3+!/cmd
4+!/cmd/**
5+!/pkg
6+!/pkg/ssg
7+!/pkg/ssg/**
8+!/.gitignore
9+!/.editorconfig
10+!/Makefile
11+!/README.md
12+!/LICENSE
13+!/go.sum
14+!/go.mod
+661,
-0
1@@ -0,0 +1,661 @@
2+ GNU AFFERO GENERAL PUBLIC LICENSE
3+ Version 3, 19 November 2007
4+
5+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
6+ Everyone is permitted to copy and distribute verbatim copies
7+ of this license document, but changing it is not allowed.
8+
9+ Preamble
10+
11+ The GNU Affero General Public License is a free, copyleft license for
12+software and other kinds of works, specifically designed to ensure
13+cooperation with the community in the case of network server software.
14+
15+ The licenses for most software and other practical works are designed
16+to take away your freedom to share and change the works. By contrast,
17+our General Public Licenses are intended to guarantee your freedom to
18+share and change all versions of a program--to make sure it remains free
19+software for all its users.
20+
21+ When we speak of free software, we are referring to freedom, not
22+price. Our General Public Licenses are designed to make sure that you
23+have the freedom to distribute copies of free software (and charge for
24+them if you wish), that you receive source code or can get it if you
25+want it, that you can change the software or use pieces of it in new
26+free programs, and that you know you can do these things.
27+
28+ Developers that use our General Public Licenses protect your rights
29+with two steps: (1) assert copyright on the software, and (2) offer
30+you this License which gives you legal permission to copy, distribute
31+and/or modify the software.
32+
33+ A secondary benefit of defending all users' freedom is that
34+improvements made in alternate versions of the program, if they
35+receive widespread use, become available for other developers to
36+incorporate. Many developers of free software are heartened and
37+encouraged by the resulting cooperation. However, in the case of
38+software used on network servers, this result may fail to come about.
39+The GNU General Public License permits making a modified version and
40+letting the public access it on a server without ever releasing its
41+source code to the public.
42+
43+ The GNU Affero General Public License is designed specifically to
44+ensure that, in such cases, the modified source code becomes available
45+to the community. It requires the operator of a network server to
46+provide the source code of the modified version running there to the
47+users of that server. Therefore, public use of a modified version, on
48+a publicly accessible server, gives the public access to the source
49+code of the modified version.
50+
51+ An older license, called the Affero General Public License and
52+published by Affero, was designed to accomplish similar goals. This is
53+a different license, not a version of the Affero GPL, but Affero has
54+released a new version of the Affero GPL which permits relicensing under
55+this license.
56+
57+ The precise terms and conditions for copying, distribution and
58+modification follow.
59+
60+ TERMS AND CONDITIONS
61+
62+ 0. Definitions.
63+
64+ "This License" refers to version 3 of the GNU Affero General Public License.
65+
66+ "Copyright" also means copyright-like laws that apply to other kinds of
67+works, such as semiconductor masks.
68+
69+ "The Program" refers to any copyrightable work licensed under this
70+License. Each licensee is addressed as "you". "Licensees" and
71+"recipients" may be individuals or organizations.
72+
73+ To "modify" a work means to copy from or adapt all or part of the work
74+in a fashion requiring copyright permission, other than the making of an
75+exact copy. The resulting work is called a "modified version" of the
76+earlier work or a work "based on" the earlier work.
77+
78+ A "covered work" means either the unmodified Program or a work based
79+on the Program.
80+
81+ To "propagate" a work means to do anything with it that, without
82+permission, would make you directly or secondarily liable for
83+infringement under applicable copyright law, except executing it on a
84+computer or modifying a private copy. Propagation includes copying,
85+distribution (with or without modification), making available to the
86+public, and in some countries other activities as well.
87+
88+ To "convey" a work means any kind of propagation that enables other
89+parties to make or receive copies. Mere interaction with a user through
90+a computer network, with no transfer of a copy, is not conveying.
91+
92+ An interactive user interface displays "Appropriate Legal Notices"
93+to the extent that it includes a convenient and prominently visible
94+feature that (1) displays an appropriate copyright notice, and (2)
95+tells the user that there is no warranty for the work (except to the
96+extent that warranties are provided), that licensees may convey the
97+work under this License, and how to view a copy of this License. If
98+the interface presents a list of user commands or options, such as a
99+menu, a prominent item in the list meets this criterion.
100+
101+ 1. Source Code.
102+
103+ The "source code" for a work means the preferred form of the work
104+for making modifications to it. "Object code" means any non-source
105+form of a work.
106+
107+ A "Standard Interface" means an interface that either is an official
108+standard defined by a recognized standards body, or, in the case of
109+interfaces specified for a particular programming language, one that
110+is widely used among developers working in that language.
111+
112+ The "System Libraries" of an executable work include anything, other
113+than the work as a whole, that (a) is included in the normal form of
114+packaging a Major Component, but which is not part of that Major
115+Component, and (b) serves only to enable use of the work with that
116+Major Component, or to implement a Standard Interface for which an
117+implementation is available to the public in source code form. A
118+"Major Component", in this context, means a major essential component
119+(kernel, window system, and so on) of the specific operating system
120+(if any) on which the executable work runs, or a compiler used to
121+produce the work, or an object code interpreter used to run it.
122+
123+ The "Corresponding Source" for a work in object code form means all
124+the source code needed to generate, install, and (for an executable
125+work) run the object code and to modify the work, including scripts to
126+control those activities. However, it does not include the work's
127+System Libraries, or general-purpose tools or generally available free
128+programs which are used unmodified in performing those activities but
129+which are not part of the work. For example, Corresponding Source
130+includes interface definition files associated with source files for
131+the work, and the source code for shared libraries and dynamically
132+linked subprograms that the work is specifically designed to require,
133+such as by intimate data communication or control flow between those
134+subprograms and other parts of the work.
135+
136+ The Corresponding Source need not include anything that users
137+can regenerate automatically from other parts of the Corresponding
138+Source.
139+
140+ The Corresponding Source for a work in source code form is that
141+same work.
142+
143+ 2. Basic Permissions.
144+
145+ All rights granted under this License are granted for the term of
146+copyright on the Program, and are irrevocable provided the stated
147+conditions are met. This License explicitly affirms your unlimited
148+permission to run the unmodified Program. The output from running a
149+covered work is covered by this License only if the output, given its
150+content, constitutes a covered work. This License acknowledges your
151+rights of fair use or other equivalent, as provided by copyright law.
152+
153+ You may make, run and propagate covered works that you do not
154+convey, without conditions so long as your license otherwise remains
155+in force. You may convey covered works to others for the sole purpose
156+of having them make modifications exclusively for you, or provide you
157+with facilities for running those works, provided that you comply with
158+the terms of this License in conveying all material for which you do
159+not control copyright. Those thus making or running the covered works
160+for you must do so exclusively on your behalf, under your direction
161+and control, on terms that prohibit them from making any copies of
162+your copyrighted material outside their relationship with you.
163+
164+ Conveying under any other circumstances is permitted solely under
165+the conditions stated below. Sublicensing is not allowed; section 10
166+makes it unnecessary.
167+
168+ 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
169+
170+ No covered work shall be deemed part of an effective technological
171+measure under any applicable law fulfilling obligations under article
172+11 of the WIPO copyright treaty adopted on 20 December 1996, or
173+similar laws prohibiting or restricting circumvention of such
174+measures.
175+
176+ When you convey a covered work, you waive any legal power to forbid
177+circumvention of technological measures to the extent such circumvention
178+is effected by exercising rights under this License with respect to
179+the covered work, and you disclaim any intention to limit operation or
180+modification of the work as a means of enforcing, against the work's
181+users, your or third parties' legal rights to forbid circumvention of
182+technological measures.
183+
184+ 4. Conveying Verbatim Copies.
185+
186+ You may convey verbatim copies of the Program's source code as you
187+receive it, in any medium, provided that you conspicuously and
188+appropriately publish on each copy an appropriate copyright notice;
189+keep intact all notices stating that this License and any
190+non-permissive terms added in accord with section 7 apply to the code;
191+keep intact all notices of the absence of any warranty; and give all
192+recipients a copy of this License along with the Program.
193+
194+ You may charge any price or no price for each copy that you convey,
195+and you may offer support or warranty protection for a fee.
196+
197+ 5. Conveying Modified Source Versions.
198+
199+ You may convey a work based on the Program, or the modifications to
200+produce it from the Program, in the form of source code under the
201+terms of section 4, provided that you also meet all of these conditions:
202+
203+ a) The work must carry prominent notices stating that you modified
204+ it, and giving a relevant date.
205+
206+ b) The work must carry prominent notices stating that it is
207+ released under this License and any conditions added under section
208+ 7. This requirement modifies the requirement in section 4 to
209+ "keep intact all notices".
210+
211+ c) You must license the entire work, as a whole, under this
212+ License to anyone who comes into possession of a copy. This
213+ License will therefore apply, along with any applicable section 7
214+ additional terms, to the whole of the work, and all its parts,
215+ regardless of how they are packaged. This License gives no
216+ permission to license the work in any other way, but it does not
217+ invalidate such permission if you have separately received it.
218+
219+ d) If the work has interactive user interfaces, each must display
220+ Appropriate Legal Notices; however, if the Program has interactive
221+ interfaces that do not display Appropriate Legal Notices, your
222+ work need not make them do so.
223+
224+ A compilation of a covered work with other separate and independent
225+works, which are not by their nature extensions of the covered work,
226+and which are not combined with it such as to form a larger program,
227+in or on a volume of a storage or distribution medium, is called an
228+"aggregate" if the compilation and its resulting copyright are not
229+used to limit the access or legal rights of the compilation's users
230+beyond what the individual works permit. Inclusion of a covered work
231+in an aggregate does not cause this License to apply to the other
232+parts of the aggregate.
233+
234+ 6. Conveying Non-Source Forms.
235+
236+ You may convey a covered work in object code form under the terms
237+of sections 4 and 5, provided that you also convey the
238+machine-readable Corresponding Source under the terms of this License,
239+in one of these ways:
240+
241+ a) Convey the object code in, or embodied in, a physical product
242+ (including a physical distribution medium), accompanied by the
243+ Corresponding Source fixed on a durable physical medium
244+ customarily used for software interchange.
245+
246+ b) Convey the object code in, or embodied in, a physical product
247+ (including a physical distribution medium), accompanied by a
248+ written offer, valid for at least three years and valid for as
249+ long as you offer spare parts or customer support for that product
250+ model, to give anyone who possesses the object code either (1) a
251+ copy of the Corresponding Source for all the software in the
252+ product that is covered by this License, on a durable physical
253+ medium customarily used for software interchange, for a price no
254+ more than your reasonable cost of physically performing this
255+ conveying of source, or (2) access to copy the
256+ Corresponding Source from a network server at no charge.
257+
258+ c) Convey individual copies of the object code with a copy of the
259+ written offer to provide the Corresponding Source. This
260+ alternative is allowed only occasionally and noncommercially, and
261+ only if you received the object code with such an offer, in accord
262+ with subsection 6b.
263+
264+ d) Convey the object code by offering access from a designated
265+ place (gratis or for a charge), and offer equivalent access to the
266+ Corresponding Source in the same way through the same place at no
267+ further charge. You need not require recipients to copy the
268+ Corresponding Source along with the object code. If the place to
269+ copy the object code is a network server, the Corresponding Source
270+ may be on a different server (operated by you or a third party)
271+ that supports equivalent copying facilities, provided you maintain
272+ clear directions next to the object code saying where to find the
273+ Corresponding Source. Regardless of what server hosts the
274+ Corresponding Source, you remain obligated to ensure that it is
275+ available for as long as needed to satisfy these requirements.
276+
277+ e) Convey the object code using peer-to-peer transmission, provided
278+ you inform other peers where the object code and Corresponding
279+ Source of the work are being offered to the general public at no
280+ charge under subsection 6d.
281+
282+ A separable portion of the object code, whose source code is excluded
283+from the Corresponding Source as a System Library, need not be
284+included in conveying the object code work.
285+
286+ A "User Product" is either (1) a "consumer product", which means any
287+tangible personal property which is normally used for personal, family,
288+or household purposes, or (2) anything designed or sold for incorporation
289+into a dwelling. In determining whether a product is a consumer product,
290+doubtful cases shall be resolved in favor of coverage. For a particular
291+product received by a particular user, "normally used" refers to a
292+typical or common use of that class of product, regardless of the status
293+of the particular user or of the way in which the particular user
294+actually uses, or expects or is expected to use, the product. A product
295+is a consumer product regardless of whether the product has substantial
296+commercial, industrial or non-consumer uses, unless such uses represent
297+the only significant mode of use of the product.
298+
299+ "Installation Information" for a User Product means any methods,
300+procedures, authorization keys, or other information required to install
301+and execute modified versions of a covered work in that User Product from
302+a modified version of its Corresponding Source. The information must
303+suffice to ensure that the continued functioning of the modified object
304+code is in no case prevented or interfered with solely because
305+modification has been made.
306+
307+ If you convey an object code work under this section in, or with, or
308+specifically for use in, a User Product, and the conveying occurs as
309+part of a transaction in which the right of possession and use of the
310+User Product is transferred to the recipient in perpetuity or for a
311+fixed term (regardless of how the transaction is characterized), the
312+Corresponding Source conveyed under this section must be accompanied
313+by the Installation Information. But this requirement does not apply
314+if neither you nor any third party retains the ability to install
315+modified object code on the User Product (for example, the work has
316+been installed in ROM).
317+
318+ The requirement to provide Installation Information does not include a
319+requirement to continue to provide support service, warranty, or updates
320+for a work that has been modified or installed by the recipient, or for
321+the User Product in which it has been modified or installed. Access to a
322+network may be denied when the modification itself materially and
323+adversely affects the operation of the network or violates the rules and
324+protocols for communication across the network.
325+
326+ Corresponding Source conveyed, and Installation Information provided,
327+in accord with this section must be in a format that is publicly
328+documented (and with an implementation available to the public in
329+source code form), and must require no special password or key for
330+unpacking, reading or copying.
331+
332+ 7. Additional Terms.
333+
334+ "Additional permissions" are terms that supplement the terms of this
335+License by making exceptions from one or more of its conditions.
336+Additional permissions that are applicable to the entire Program shall
337+be treated as though they were included in this License, to the extent
338+that they are valid under applicable law. If additional permissions
339+apply only to part of the Program, that part may be used separately
340+under those permissions, but the entire Program remains governed by
341+this License without regard to the additional permissions.
342+
343+ When you convey a copy of a covered work, you may at your option
344+remove any additional permissions from that copy, or from any part of
345+it. (Additional permissions may be written to require their own
346+removal in certain cases when you modify the work.) You may place
347+additional permissions on material, added by you to a covered work,
348+for which you have or can give appropriate copyright permission.
349+
350+ Notwithstanding any other provision of this License, for material you
351+add to a covered work, you may (if authorized by the copyright holders of
352+that material) supplement the terms of this License with terms:
353+
354+ a) Disclaiming warranty or limiting liability differently from the
355+ terms of sections 15 and 16 of this License; or
356+
357+ b) Requiring preservation of specified reasonable legal notices or
358+ author attributions in that material or in the Appropriate Legal
359+ Notices displayed by works containing it; or
360+
361+ c) Prohibiting misrepresentation of the origin of that material, or
362+ requiring that modified versions of such material be marked in
363+ reasonable ways as different from the original version; or
364+
365+ d) Limiting the use for publicity purposes of names of licensors or
366+ authors of the material; or
367+
368+ e) Declining to grant rights under trademark law for use of some
369+ trade names, trademarks, or service marks; or
370+
371+ f) Requiring indemnification of licensors and authors of that
372+ material by anyone who conveys the material (or modified versions of
373+ it) with contractual assumptions of liability to the recipient, for
374+ any liability that these contractual assumptions directly impose on
375+ those licensors and authors.
376+
377+ All other non-permissive additional terms are considered "further
378+restrictions" within the meaning of section 10. If the Program as you
379+received it, or any part of it, contains a notice stating that it is
380+governed by this License along with a term that is a further
381+restriction, you may remove that term. If a license document contains
382+a further restriction but permits relicensing or conveying under this
383+License, you may add to a covered work material governed by the terms
384+of that license document, provided that the further restriction does
385+not survive such relicensing or conveying.
386+
387+ If you add terms to a covered work in accord with this section, you
388+must place, in the relevant source files, a statement of the
389+additional terms that apply to those files, or a notice indicating
390+where to find the applicable terms.
391+
392+ Additional terms, permissive or non-permissive, may be stated in the
393+form of a separately written license, or stated as exceptions;
394+the above requirements apply either way.
395+
396+ 8. Termination.
397+
398+ You may not propagate or modify a covered work except as expressly
399+provided under this License. Any attempt otherwise to propagate or
400+modify it is void, and will automatically terminate your rights under
401+this License (including any patent licenses granted under the third
402+paragraph of section 11).
403+
404+ However, if you cease all violation of this License, then your
405+license from a particular copyright holder is reinstated (a)
406+provisionally, unless and until the copyright holder explicitly and
407+finally terminates your license, and (b) permanently, if the copyright
408+holder fails to notify you of the violation by some reasonable means
409+prior to 60 days after the cessation.
410+
411+ Moreover, your license from a particular copyright holder is
412+reinstated permanently if the copyright holder notifies you of the
413+violation by some reasonable means, this is the first time you have
414+received notice of violation of this License (for any work) from that
415+copyright holder, and you cure the violation prior to 30 days after
416+your receipt of the notice.
417+
418+ Termination of your rights under this section does not terminate the
419+licenses of parties who have received copies or rights from you under
420+this License. If your rights have been terminated and not permanently
421+reinstated, you do not qualify to receive new licenses for the same
422+material under section 10.
423+
424+ 9. Acceptance Not Required for Having Copies.
425+
426+ You are not required to accept this License in order to receive or
427+run a copy of the Program. Ancillary propagation of a covered work
428+occurring solely as a consequence of using peer-to-peer transmission
429+to receive a copy likewise does not require acceptance. However,
430+nothing other than this License grants you permission to propagate or
431+modify any covered work. These actions infringe copyright if you do
432+not accept this License. Therefore, by modifying or propagating a
433+covered work, you indicate your acceptance of this License to do so.
434+
435+ 10. Automatic Licensing of Downstream Recipients.
436+
437+ Each time you convey a covered work, the recipient automatically
438+receives a license from the original licensors, to run, modify and
439+propagate that work, subject to this License. You are not responsible
440+for enforcing compliance by third parties with this License.
441+
442+ An "entity transaction" is a transaction transferring control of an
443+organization, or substantially all assets of one, or subdividing an
444+organization, or merging organizations. If propagation of a covered
445+work results from an entity transaction, each party to that
446+transaction who receives a copy of the work also receives whatever
447+licenses to the work the party's predecessor in interest had or could
448+give under the previous paragraph, plus a right to possession of the
449+Corresponding Source of the work from the predecessor in interest, if
450+the predecessor has it or can get it with reasonable efforts.
451+
452+ You may not impose any further restrictions on the exercise of the
453+rights granted or affirmed under this License. For example, you may
454+not impose a license fee, royalty, or other charge for exercise of
455+rights granted under this License, and you may not initiate litigation
456+(including a cross-claim or counterclaim in a lawsuit) alleging that
457+any patent claim is infringed by making, using, selling, offering for
458+sale, or importing the Program or any portion of it.
459+
460+ 11. Patents.
461+
462+ A "contributor" is a copyright holder who authorizes use under this
463+License of the Program or a work on which the Program is based. The
464+work thus licensed is called the contributor's "contributor version".
465+
466+ A contributor's "essential patent claims" are all patent claims
467+owned or controlled by the contributor, whether already acquired or
468+hereafter acquired, that would be infringed by some manner, permitted
469+by this License, of making, using, or selling its contributor version,
470+but do not include claims that would be infringed only as a
471+consequence of further modification of the contributor version. For
472+purposes of this definition, "control" includes the right to grant
473+patent sublicenses in a manner consistent with the requirements of
474+this License.
475+
476+ Each contributor grants you a non-exclusive, worldwide, royalty-free
477+patent license under the contributor's essential patent claims, to
478+make, use, sell, offer for sale, import and otherwise run, modify and
479+propagate the contents of its contributor version.
480+
481+ In the following three paragraphs, a "patent license" is any express
482+agreement or commitment, however denominated, not to enforce a patent
483+(such as an express permission to practice a patent or covenant not to
484+sue for patent infringement). To "grant" such a patent license to a
485+party means to make such an agreement or commitment not to enforce a
486+patent against the party.
487+
488+ If you convey a covered work, knowingly relying on a patent license,
489+and the Corresponding Source of the work is not available for anyone
490+to copy, free of charge and under the terms of this License, through a
491+publicly available network server or other readily accessible means,
492+then you must either (1) cause the Corresponding Source to be so
493+available, or (2) arrange to deprive yourself of the benefit of the
494+patent license for this particular work, or (3) arrange, in a manner
495+consistent with the requirements of this License, to extend the patent
496+license to downstream recipients. "Knowingly relying" means you have
497+actual knowledge that, but for the patent license, your conveying the
498+covered work in a country, or your recipient's use of the covered work
499+in a country, would infringe one or more identifiable patents in that
500+country that you have reason to believe are valid.
501+
502+ If, pursuant to or in connection with a single transaction or
503+arrangement, you convey, or propagate by procuring conveyance of, a
504+covered work, and grant a patent license to some of the parties
505+receiving the covered work authorizing them to use, propagate, modify
506+or convey a specific copy of the covered work, then the patent license
507+you grant is automatically extended to all recipients of the covered
508+work and works based on it.
509+
510+ A patent license is "discriminatory" if it does not include within
511+the scope of its coverage, prohibits the exercise of, or is
512+conditioned on the non-exercise of one or more of the rights that are
513+specifically granted under this License. You may not convey a covered
514+work if you are a party to an arrangement with a third party that is
515+in the business of distributing software, under which you make payment
516+to the third party based on the extent of your activity of conveying
517+the work, and under which the third party grants, to any of the
518+parties who would receive the covered work from you, a discriminatory
519+patent license (a) in connection with copies of the covered work
520+conveyed by you (or copies made from those copies), or (b) primarily
521+for and in connection with specific products or compilations that
522+contain the covered work, unless you entered into that arrangement,
523+or that patent license was granted, prior to 28 March 2007.
524+
525+ Nothing in this License shall be construed as excluding or limiting
526+any implied license or other defenses to infringement that may
527+otherwise be available to you under applicable patent law.
528+
529+ 12. No Surrender of Others' Freedom.
530+
531+ If conditions are imposed on you (whether by court order, agreement or
532+otherwise) that contradict the conditions of this License, they do not
533+excuse you from the conditions of this License. If you cannot convey a
534+covered work so as to satisfy simultaneously your obligations under this
535+License and any other pertinent obligations, then as a consequence you may
536+not convey it at all. For example, if you agree to terms that obligate you
537+to collect a royalty for further conveying from those to whom you convey
538+the Program, the only way you could satisfy both those terms and this
539+License would be to refrain entirely from conveying the Program.
540+
541+ 13. Remote Network Interaction; Use with the GNU General Public License.
542+
543+ Notwithstanding any other provision of this License, if you modify the
544+Program, your modified version must prominently offer all users
545+interacting with it remotely through a computer network (if your version
546+supports such interaction) an opportunity to receive the Corresponding
547+Source of your version by providing access to the Corresponding Source
548+from a network server at no charge, through some standard or customary
549+means of facilitating copying of software. This Corresponding Source
550+shall include the Corresponding Source for any work covered by version 3
551+of the GNU General Public License that is incorporated pursuant to the
552+following paragraph.
553+
554+ Notwithstanding any other provision of this License, you have
555+permission to link or combine any covered work with a work licensed
556+under version 3 of the GNU General Public License into a single
557+combined work, and to convey the resulting work. The terms of this
558+License will continue to apply to the part which is the covered work,
559+but the work with which it is combined will remain governed by version
560+3 of the GNU General Public License.
561+
562+ 14. Revised Versions of this License.
563+
564+ The Free Software Foundation may publish revised and/or new versions of
565+the GNU Affero General Public License from time to time. Such new versions
566+will be similar in spirit to the present version, but may differ in detail to
567+address new problems or concerns.
568+
569+ Each version is given a distinguishing version number. If the
570+Program specifies that a certain numbered version of the GNU Affero General
571+Public License "or any later version" applies to it, you have the
572+option of following the terms and conditions either of that numbered
573+version or of any later version published by the Free Software
574+Foundation. If the Program does not specify a version number of the
575+GNU Affero General Public License, you may choose any version ever published
576+by the Free Software Foundation.
577+
578+ If the Program specifies that a proxy can decide which future
579+versions of the GNU Affero General Public License can be used, that proxy's
580+public statement of acceptance of a version permanently authorizes you
581+to choose that version for the Program.
582+
583+ Later license versions may give you additional or different
584+permissions. However, no additional obligations are imposed on any
585+author or copyright holder as a result of your choosing to follow a
586+later version.
587+
588+ 15. Disclaimer of Warranty.
589+
590+ THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
591+APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
592+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
593+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
594+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
595+PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
596+IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
597+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
598+
599+ 16. Limitation of Liability.
600+
601+ IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
602+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
603+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
604+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
605+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
606+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
607+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
608+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
609+SUCH DAMAGES.
610+
611+ 17. Interpretation of Sections 15 and 16.
612+
613+ If the disclaimer of warranty and limitation of liability provided
614+above cannot be given local legal effect according to their terms,
615+reviewing courts shall apply local law that most closely approximates
616+an absolute waiver of all civil liability in connection with the
617+Program, unless a warranty or assumption of liability accompanies a
618+copy of the Program in return for a fee.
619+
620+ END OF TERMS AND CONDITIONS
621+
622+ How to Apply These Terms to Your New Programs
623+
624+ If you develop a new program, and you want it to be of the greatest
625+possible use to the public, the best way to achieve this is to make it
626+free software which everyone can redistribute and change under these terms.
627+
628+ To do so, attach the following notices to the program. It is safest
629+to attach them to the start of each source file to most effectively
630+state the exclusion of warranty; and each file should have at least
631+the "copyright" line and a pointer to where the full notice is found.
632+
633+ <one line to give the program's name and a brief idea of what it does.>
634+ Copyright (C) <year> <name of author>
635+
636+ This program is free software: you can redistribute it and/or modify
637+ it under the terms of the GNU Affero General Public License as published by
638+ the Free Software Foundation, either version 3 of the License, or
639+ (at your option) any later version.
640+
641+ This program is distributed in the hope that it will be useful,
642+ but WITHOUT ANY WARRANTY; without even the implied warranty of
643+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
644+ GNU Affero General Public License for more details.
645+
646+ You should have received a copy of the GNU Affero General Public License
647+ along with this program. If not, see <https://www.gnu.org/licenses/>.
648+
649+Also add information on how to contact you by electronic and paper mail.
650+
651+ If your software can interact with users remotely through a computer
652+network, you should also make sure that it provides a way for users to
653+get its source. For example, if your program is a web application, its
654+interface could display a "Source" link that leads users to an archive
655+of the code. There are many ways you could offer source, and different
656+solutions will be better for different programs; see section 13 for the
657+specific requirements.
658+
659+ You should also get your employer (if you work as a programmer) or school,
660+if any, to sign a "copyright disclaimer" for the program, if necessary.
661+For more information on this, and how to apply and follow the GNU AGPL, see
662+<https://www.gnu.org/licenses/>.
+15,
-0
1@@ -0,0 +1,15 @@
2+.POSIX:
3+
4+GO ?= go
5+
6+all:
7+ $(GO) build ./cmd/glerc
8+
9+clean:
10+ rm glerc
11+
12+lint:
13+ $(GO) fmt ./...
14+ $(GO) vet ./...
15+ $(GO) fix ./...
16+ staticcheck ./...
+28,
-0
1@@ -0,0 +1,28 @@
2+# glerc
3+
4+A small, werc-inspired and easy to use SSG, written in Go - Write pages in markdown, get them back as HTML files with a nice lil sidebar :D
5+
6+## building
7+
8+To build glerc, you need `go >= 1.26.2`.
9+
10+Running `make` in the root of the repository should give you a binary called `./glerc`
11+
12+## usage
13+
14+We recommend you look at [The Dani Museum](https://codeberg.org/dani-institute/pages) to get an idea of what a page in glerc should look like.
15+
16+The rundown is this:
17+- HTML templates go in `templates/` and must end with `.html`.
18+- Assets (CSS, JS, images) go in `assets/`, we recommend organising them.
19+- Pages go in `pages/` and must end with `.md`.
20+
21+(Documentation on what options the HTML template accepts will be documented when possible.)
22+
23+## configuration
24+
25+Use `config.toml` to set your site's title, description and base URL. You can also set the sidebar order by doing the following :3
26+
27+```toml
28+sidebar_order = ["index", "page1", "page2"]
29+```
+105,
-0
1@@ -0,0 +1,105 @@
2+package main
3+
4+import (
5+ "context"
6+ "log/slog"
7+ "os"
8+ "path/filepath"
9+ "strings"
10+
11+ "codeberg.org/dani-institute/pages/pkg/ssg"
12+ "github.com/urfave/cli/v3"
13+ "github.com/yuin/goldmark"
14+ meta "github.com/yuin/goldmark-meta"
15+ "github.com/yuin/goldmark/parser"
16+)
17+
18+var cmd = cli.Command{
19+ Name: "generate_pages",
20+ Version: "2026.5.0",
21+ Flags: []cli.Flag{
22+ &cli.StringFlag{
23+ Name: "base-url",
24+ Value: "",
25+ },
26+ &cli.StringFlag{
27+ Name: "config",
28+ Value: "./config.toml",
29+ },
30+ &cli.StringFlag{
31+ Name: "templates-dir",
32+ Value: "./templates",
33+ },
34+ &cli.StringFlag{
35+ Name: "pages-dir",
36+ Value: "./pages",
37+ },
38+ &cli.StringFlag{
39+ Name: "assets-dir",
40+ Value: "./assets",
41+ },
42+ &cli.StringFlag{
43+ Name: "output-dir",
44+ Value: "./output",
45+ },
46+ },
47+ Action: mainAction,
48+}
49+
50+func mainAction(ctx context.Context, c *cli.Command) error {
51+ slog.Info("generating pages")
52+ var config ssg.Config
53+ baseUrl := c.String("base-url")
54+ _ = baseUrl
55+ configFile := c.String("config")
56+ if err := ssg.LoadConfigFile(configFile, &config); err != nil {
57+ return err
58+ }
59+ pagesDir := c.String("pages-dir")
60+ pages, err := ssg.GetPages(pagesDir)
61+ if err != nil {
62+ return err
63+ }
64+ templatesDir := c.String("templates-dir")
65+ templates, err := ssg.GetTemplates(templatesDir)
66+ if err != nil {
67+ return err
68+ }
69+ sidebar, err := ssg.GetSidebar(pagesDir, config.SidebarOrder)
70+ if err != nil {
71+ return err
72+ }
73+ outputDir := c.String("output-dir")
74+ if err := os.MkdirAll(outputDir, 0o700); os.IsNotExist(err) {
75+ return err
76+ }
77+ assetsDir := c.String("assets-dir")
78+ if err := ssg.CopyDir(assetsDir, outputDir); err != nil {
79+ return err
80+ }
81+ markdown := goldmark.New(
82+ goldmark.WithExtensions(meta.Meta),
83+ goldmark.WithParserOptions(parser.WithAutoHeadingID()),
84+ )
85+ for path, page := range pages {
86+ name := strings.TrimSuffix(filepath.Base(path), ".md")
87+ slog.Info("building page", "page", name)
88+ outputPath := filepath.Join(outputDir, name) + ".html"
89+ f, err := os.Create(outputPath)
90+ if err != nil {
91+ return err
92+ }
93+ defer f.Close()
94+ if err := ssg.BuildPage(f, name, path, page, markdown, templates, config, baseUrl, sidebar); err != nil {
95+ return err
96+ }
97+ }
98+ return nil
99+}
100+
101+func main() {
102+ if err := cmd.Run(context.Background(), os.Args); err != nil {
103+ slog.Error("got err while generating pages", "err", err)
104+ os.Exit(1)
105+ }
106+}
+11,
-0
1@@ -0,0 +1,11 @@
2+module codeberg.org/dani-institute/pages
3+
4+go 1.26.2
5+
6+require (
7+ github.com/BurntSushi/toml v1.6.0 // indirect
8+ github.com/urfave/cli/v3 v3.8.0 // indirect
9+ github.com/yuin/goldmark v1.8.2 // indirect
10+ github.com/yuin/goldmark-meta v1.1.0 // indirect
11+ gopkg.in/yaml.v2 v2.3.0 // indirect
12+)
+11,
-0
1@@ -0,0 +1,11 @@
2+github.com/BurntSushi/toml v1.6.0 h1:dRaEfpa2VI55EwlIW72hMRHdWouJeRF7TPYhI+AUQjk=
3+github.com/BurntSushi/toml v1.6.0/go.mod h1:ukJfTF/6rtPPRCnwkur4qwRxa8vTRFBF0uk2lLoLwho=
4+github.com/urfave/cli/v3 v3.8.0 h1:XqKPrm0q4P0q5JpoclYoCAv0/MIvH/jZ2umzuf8pNTI=
5+github.com/urfave/cli/v3 v3.8.0/go.mod h1:ysVLtOEmg2tOy6PknnYVhDoouyC/6N42TMeoMzskhso=
6+github.com/yuin/goldmark v1.8.2 h1:kEGpgqJXdgbkhcOgBxkC0X0PmoPG1ZyoZ117rDVp4zE=
7+github.com/yuin/goldmark v1.8.2/go.mod h1:ip/1k0VRfGynBgxOz0yCqHrbZXhcjxyuS66Brc7iBKg=
8+github.com/yuin/goldmark-meta v1.1.0 h1:pWw+JLHGZe8Rk0EGsMVssiNb/AaPMHfSRszZeUeiOUc=
9+github.com/yuin/goldmark-meta v1.1.0/go.mod h1:U4spWENafuA7Zyg+Lj5RqK/MF+ovMYtBvXi1lBb2VP0=
10+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
11+gopkg.in/yaml.v2 v2.3.0 h1:clyUAQHOM3G0M3f5vQj7LuJrETvjVot3Z5el9nffUtU=
12+gopkg.in/yaml.v2 v2.3.0/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
+26,
-0
1@@ -0,0 +1,26 @@
2+package ssg
3+
4+import (
5+ "os"
6+
7+ "github.com/BurntSushi/toml"
8+)
9+
10+type Config struct {
11+ BaseURL string `toml:"base_url"`
12+ Title string `toml:"title"`
13+ Description string `toml:"description"`
14+ Extra map[string]any `toml:"extra"`
15+ SidebarOrder []string `toml:"sidebar_order"`
16+}
17+
18+func LoadConfigFile(fn string, config *Config) error {
19+ out, err := os.ReadFile(fn)
20+ if err != nil {
21+ return err
22+ }
23+ if err := toml.Unmarshal(out, config); err != nil {
24+ return err
25+ }
26+ return nil
27+}
+103,
-0
1@@ -0,0 +1,103 @@
2+package ssg
3+
4+import (
5+ "bytes"
6+ "io"
7+ "io/fs"
8+ "log/slog"
9+ "os"
10+ "path/filepath"
11+ "strings"
12+
13+ "github.com/yuin/goldmark"
14+ "github.com/yuin/goldmark-meta"
15+ "github.com/yuin/goldmark/parser"
16+)
17+
18+type PageError int
19+
20+const (
21+ _ PageError = iota
22+ NonExistentTemplate
23+)
24+
25+func (e PageError) Error() string {
26+ switch e {
27+ case NonExistentTemplate:
28+ return "given template does not exist"
29+ }
30+ panic("this should not be reached")
31+}
32+
33+func GetPages(dir string) (map[string]string, error) {
34+ res := make(map[string]string, 0)
35+ err := filepath.WalkDir(dir, func(path string, d fs.DirEntry, err error) error {
36+ if err != nil {
37+ slog.Error("got err while reading path", "path", path, "err", err)
38+ return filepath.SkipDir
39+ }
40+ if !d.IsDir() && strings.HasSuffix(path, ".md") {
41+ content, err := os.ReadFile(path)
42+ if err != nil {
43+ slog.Error("got err while reading file", "file", path, "err", err)
44+ return filepath.SkipDir
45+ }
46+ res[path] = string(content)
47+ }
48+ return nil
49+ })
50+ if err != nil {
51+ return res, err
52+ }
53+ return res, nil
54+}
55+
56+func BuildPage(w io.Writer, name string, path string, page string, markdown goldmark.Markdown, templates Templates, config Config, baseUrl string, sidebar []SidebarItem) error {
57+ var buff bytes.Buffer
58+ ctx := parser.NewContext()
59+ if err := markdown.Convert([]byte(page), &buff, parser.WithContext(ctx)); err != nil {
60+ return err
61+ }
62+ frontmatter := meta.Get(ctx)
63+ var templateName string
64+ switch v := frontmatter["template"]; v {
65+ case nil:
66+ if name == "index" {
67+ templateName = "index"
68+ } else {
69+ templateName = "page"
70+ }
71+ default:
72+ templateName = v.(string)
73+ }
74+ if baseUrl == "" {
75+ baseUrl = config.BaseURL
76+ }
77+ var title string
78+ switch v := frontmatter["title"]; v {
79+ case nil:
80+ title = config.Title
81+ default:
82+ title = v.(string)
83+ }
84+ var description string
85+ switch v := frontmatter["description"]; v {
86+ case nil:
87+ description = config.Description
88+ default:
89+ description = v.(string)
90+ }
91+ templateData := TemplateData{
92+ Title: title,
93+ Description: description,
94+ BaseURL: baseUrl,
95+ Params: frontmatter,
96+ Config: config,
97+ Content: buff.String(),
98+ Sidebar: sidebar,
99+ }
100+ if err := BuildTemplate(w, name, templates[templateName], templateData); err != nil {
101+ return err
102+ }
103+ return nil
104+}
1@@ -0,0 +1,43 @@
2+package ssg
3+
4+import (
5+ "os"
6+ "sort"
7+ "strings"
8+)
9+
10+func GetSidebar(pagesDir string, order []string) ([]SidebarItem, error) {
11+ entries, err := os.ReadDir(pagesDir)
12+ if err != nil {
13+ return nil, err
14+ }
15+
16+ var nav []SidebarItem
17+
18+ for _, entry := range entries {
19+ name := entry.Name()
20+ stem, ok := strings.CutSuffix(name, ".md")
21+ if !ok {
22+ continue
23+ }
24+ nav = append(nav, SidebarItem{
25+ Name: stem,
26+ Path: stem + ".html",
27+ })
28+ }
29+
30+ sort.Slice(nav, func(i, j int) bool {
31+ iIdx, jIdx := len(order), len(order)
32+ for k, v := range order {
33+ if nav[i].Name == v {
34+ iIdx = k
35+ }
36+ if nav[j].Name == v {
37+ jIdx = k
38+ }
39+ }
40+ return iIdx < jIdx
41+ })
42+
43+ return nav, nil
44+}
+73,
-0
1@@ -0,0 +1,73 @@
2+package ssg
3+
4+import (
5+ "io"
6+ "os"
7+ "path/filepath"
8+ "strings"
9+ "text/template"
10+)
11+
12+type TemplateData struct {
13+ Title string
14+ Description string
15+ BaseURL string
16+ Params map[string]any
17+ Config Config
18+ Content string
19+ Sidebar []SidebarItem
20+}
21+
22+type SidebarItem struct {
23+ Name string
24+ Path string
25+}
26+
27+type Templates map[string]string
28+
29+func DefaultTemplateData() TemplateData {
30+ return TemplateData{
31+ Title: "",
32+ Description: "",
33+ BaseURL: "",
34+ Params: map[string]any{},
35+ Config: Config{},
36+ Content: "",
37+ }
38+}
39+
40+func BuildTemplate(w io.Writer, name string, t string, data TemplateData) error {
41+ master, err := template.New(name).Parse(t)
42+ if err != nil {
43+ return err
44+ }
45+ _, err = master.New("content").Parse(data.Content)
46+ if err != nil {
47+ return err
48+ }
49+ if err := master.ExecuteTemplate(w, name, data); err != nil {
50+ return err
51+ }
52+ return nil
53+}
54+
55+func GetTemplates(dir string) (Templates, error) {
56+ res := make(map[string]string, 0)
57+ entries, err := os.ReadDir(dir)
58+ if err != nil {
59+ return res, err
60+ }
61+ for _, entry := range entries {
62+ entryName := entry.Name()
63+ if !strings.HasSuffix(entryName, ".html") {
64+ continue
65+ }
66+ name := strings.TrimSuffix(filepath.Base(entryName), ".html")
67+ content, err := os.ReadFile(filepath.Join(dir, entryName))
68+ if err != nil {
69+ return res, err
70+ }
71+ res[name] = string(content)
72+ }
73+ return res, nil
74+}
+57,
-0
1@@ -0,0 +1,57 @@
2+package ssg
3+
4+import (
5+ "io"
6+ "os"
7+ "path/filepath"
8+)
9+
10+func CopyDir(source string, destination string) error {
11+ srcInfo, err := os.Stat(source)
12+ if err != nil {
13+ return err
14+ }
15+ if err := os.MkdirAll(destination, srcInfo.Mode()); err != nil {
16+ return err
17+ }
18+ entries, err := os.ReadDir(source)
19+ if err != nil {
20+ return err
21+ }
22+ for _, entry := range entries {
23+ entrySrc := filepath.Join(source, entry.Name())
24+ entryDest := filepath.Join(destination, entry.Name())
25+ if entry.IsDir() {
26+ if err := CopyDir(entrySrc, entryDest); err != nil {
27+ return err
28+ }
29+ } else {
30+ if err := CopyFile(entrySrc, entryDest); err != nil {
31+ return err
32+ }
33+ }
34+ }
35+ return nil
36+}
37+
38+func CopyFile(srcPath string, destPath string) error {
39+ info, err := os.Stat(srcPath)
40+ if err != nil {
41+ return err
42+ }
43+ src, err := os.Open(srcPath)
44+ if err != nil {
45+ return err
46+ }
47+ defer src.Close()
48+ dest, err := os.OpenFile(destPath, os.O_WRONLY|os.O_CREATE, info.Mode())
49+ if err != nil {
50+ return err
51+ }
52+ defer dest.Close()
53+ _, err = io.Copy(dest, src)
54+ if err != nil {
55+ return err
56+ }
57+ return nil
58+}