(BACKUP REPOSITORY) The Homestuck Music Wiki - static wiki software cataloguing collaborative creation https://hsmusic.wiki/
(quasar) nebula b5fea706af really wip experimental focus ring stuff | 2 年之前 | |
---|---|---|
src | 2 年之前 | |
test | 2 年之前 | |
.gitignore | 4 年之前 | |
LICENSE.txt | 5 年之前 | |
README.md | 3 年之前 | |
package-lock.json | 2 年之前 | |
package.json | 2 年之前 | |
publish.sh | 4 年之前 |
HSMusic, short for the Homestuck Music Wiki, is a revitalization and reimagining of earlier projects archiving and celebrating the expansive history of Homestuck official and fan music. Roughly periodic releases of the website are released at hsmusic.wiki; all development occurs in this public Git repository, which can be accessed at notabug.org.
Disclaimer: most of the code here sucks. It's been shambled together over the course of over a year, and while we're fairly confident it's all at minimum functional, we can't guarantee the same about its understandability! Still, for the official release of hsmusic.wiki, we've done our best to put together a codebase which is somewhat navigable. The description below summarizes it:
src/upd8.js
: "Build" code for the site. Everything specific to generating the structure and HTML content of the website is conatined in this file. As expected, it's pretty massive, and is currently undergoing some much-belated restructuring.src/static
: Static code and supporting files. Everything here is wholly client-side and referenced by the generated HTML files.src/common
: Code which is depended upon by both client- and server-side code. For the most part, this is constants such as directory paths, though there are a few handy algorithms here too.data
and media
folders too. Today, for portability and convenience in project structure, those are saved in separate repositories, and you can pass hsmusic paths to them through the --data-path
and --media-path
options, or the HSMUSIC_DATA
and HSMUSIC_MEDIA
environment variables.
site
folder; today, use --out-path
or HSMUSIC_OUT
!The upd8 code process was politely introduced by 2019!us back when we were beginning the site, and it's essentially the same structure followed today. In summary:
The majority of the code volume is generated HTML content and supporting utility functions; while we've attempted to keep the update file more or less organized, the most reliable way to navigate is to just ctrl-F for the function definitions of whatever you intend to work on. Code order isn't super strict since everything is handled by separate function calls (which all branch off of the "main" function at the end of the file).
In the past, data, HTML, and media files were all interspersed with each other. Yea, even the generated HTML files were included as part of the repository; their diffs, part of every commit. Those were dark times indeed.
hsmusic is a relatively generic music wiki software, so you're more than encouraged to create a fork for your own archival or cataloguing purposes! You're encouraged to drop us a link if you do - we'd love to hear from you.
Still, at present moment, a fair bit of the wiki design is baked into the update code itself - any configuration (such as getting rid of the "flashes & games") section will have you digging into the code yourself. In the future, we'd love to make the wiki software more customizable from a forking perspective, but we haven't gotten to it yet. Let us know if this is something you're interested in - we'd love to chat about what additions or changes would be useful in making a more versatile generic music wiki software!
As mentioned, part of the focus of the hsmusic.wiki release was to create a more modular and develop-able repository. So, on the curious chance anyone would like to contribute code to the repo, such is certainly capable now!
Still, for larger additions, I'd encourage you to throw an email or contact (links here) before writing all the implementation code: besides code tips which might make your life a bit easier (questions are welcome), I'd also love to discuss feature designs and values while they're still being brainstormed! That way, I don't need to tell you there are fundamental ideas or code details I'd want rebuilt - the last thing I want is anyone putting hours into code which could have been avoided being poured down the drain!
As ever, feedback is always welcome, and may be shared via the usual links. Thank you for checking the repository out!