The new Ripple frontend.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Giuseppe Guerra 3fc0620d69 Merge branch 'master' of zxq.co:ripple/hanayo 3 月之前
data Ranking criteria fixes 4 月之前
modules Updated hardcoded server ips 6 月之前
routers Bancho API privs, Bancho OAuth, update api vendor 4 月之前
scripts Update locales 1 年之前
semantic Fix placeholder color being completely white 2 年之前
services Finish token creation pages 2 年之前
static Bancho API privs, Bancho OAuth, update api vendor 4 月之前
templates Ranking criteria fixes 4 月之前
vendor Bancho API privs, Bancho OAuth, update api vendor 4 月之前
website-docs @ 1bd4238f62 Updated submodule website-docs 3 月之前
.drone.yml add drone 1 年之前
.editorconfig add drone 1 年之前
.eslintrc eslint config 1 年之前
.gitignore Add basic oauth flow 2 年之前
.gitmodules Add submodule website-docs 2 年之前
2fa.go append query to redir URL in 2fa 2 年之前
Gopkg.lock Bancho API privs, Bancho OAuth, update api vendor 4 月之前
Gopkg.toml require license to be agreed before starting hanayo 1 年之前
LICENSE Forgetting we are using GNU AGPL: check 3 年之前
README.md Explain why you shouldn't write code like hanayo in the README 1 年之前
avatar.go ADD EVERYTHING TO TEMPLATES FILE OH YEAH 2 年之前
beatmap.go merge appends and remove shiet 1 年之前
context.go fix breaking changes 1 年之前
dev.go Bancho API privs, Bancho OAuth, update api vendor 4 月之前
doc.go ⬆️ v1.8.6 ⬆️ 1 年之前
errors.go ADD EVERYTHING TO TEMPLATES FILE OH YEAH 2 年之前
funcmap.go Play Time 7 月之前
gulpfile.js make dark site a real setting instead of an easter egg 1 年之前
helpers.go pass valid context to Exchange code 1 年之前
irc.go ADD EVERYTHING TO TEMPLATES FILE OH YEAH 2 年之前
loadchangelog.go Support for new changelog format 11 月之前
localisation.go Make website show localised text 2 年之前
login.go ADD EVERYTHING TO TEMPLATES FILE OH YEAH 2 年之前
main.go require license to be agreed before starting hanayo 1 年之前
messages.go Add messages system (for {error,success,info,...} messages) 3 年之前
oauth.go Add X-Frame-Options: deny to OAuth token requests 2 年之前
package.json Start implementing localisation in JavaScript 2 年之前
profbackground.go Slight increase of 13% of profile background quality 2 年之前
profile.go ADD EVERYTHING TO TEMPLATES FILE OH YEAH 2 年之前
pw.go Create token revocation page 2 年之前
rate_limiter.go use getContext instead of MustGet("context").(context) 3 年之前
recovery.go Update vendor 2 年之前
register.go Don't add user to leaderboard when they register 2 年之前
semantic.json Display achievements on user profiles 1 年之前
sessions.go Make Language set in the Context, not by the template 2 年之前
simple.go ADD EVERYTHING TO TEMPLATES FILE OH YEAH 2 年之前
startuato_linux.go deploy a specific branch 2 年之前
startuato_windows.go When refreshing templates, restart the entire webserver 3 年之前
templates.go ignore non-html files while loading templates 1 年之前
tracking.go Move from git.zxq.co to zxq.co 2 年之前
yarn.lock Start implementing localisation in JavaScript 2 年之前

README.md

Hanayo build status

This repository has a mirror here. The original repo is still here.

To fellow developers: this is not how you do it!

The biggest flaw of hanayo are that when I set out to create it, I wanted to create a template system that:

  • Created a handler by simply having the file “be there”
  • Could fetch the data it needed on its own, often from the Ripple API
  • Had the actual Go code be as little as possible

This was not immediately evident to me, a Go beginner, but what I did there was basically make Go be PHP.

The biggest lesson I learned on how to properly do templates, was learning to use Vue. Yes, Vue can be used for the frontend and not really for server-rendered stuff, but even just learning how to do stuff with it can help you understand what a template is actually supposed to be in order to be maintainable.

The key concepts and insights for me where:

  • Separating clearly code and markup, making the template declarative and keeping as little code in the template
  • A template should be purely functional. Its mere creation should not generate side effects, nor should it be dependent on things that are not its precise inputs: for a given input there is a specific output.
  • The concept of component as a single self-contained entity which is the same wherever you use it is very powerful.
  • Once a template/component starts becoming too big, split it into more components.

But don’t stop here. Actually making a project using Vue helps you to understand this much more easily than using mere words. Go ahead and build something, even if just to play around!