LESANA-INIT(1)

📦
version 0.10.1 · 5 versions
, in debian trixie, ubuntu questing

✨ LESANA-INIT ✨

okay bestie, buckle up — this is the lesana-init manual page, aka the glow-up starter pack for a brand new lesana collection 💖

🌸 NAME 🌸

lesana-init — the little command that initializes a lesana collection, no cap 🎀

🦋 SYNOPSIS 🦋

lesana init [–help] [–collection <collection>] [–no-git]

💅 DESCRIPTION 💅

so like, lesana init is the moment where a fresh new lesana collection is born. iconic behavior honestly. 🌈

It creates the directory (yes, even if it does not exist yet — it just makes it, main character energy) and then, unless --no-git is specified, it will:

  • initialize that directory as a git repository,
  • create a .gitignore file with some relevant contents, and
  • add hooks to update the local cache whenever the files are changed via git.

Then it creates a skeleton settings.yaml file and opens it up in an editor so you can start configuring the collection. yes you literally get to sit there and customize your lil setup 🫶

When you leave the editor, again unless --no-git is used, it will add this file to the git staging area — but not commit it. it's giving "staged, not shipped" 😌

⭐ real talk though: it is safe to run this command on an existing repository, e.g. to install the hooks on a new clone. BUT — and this is the important bit — it will overwrite the hooks themselves even if they have been changed by the user. so like, heads up, your custom hook edits are getting ate. 💀

🎀 OPTIONS 🎀

  • --help, -h — prints an help message and exits. that's it, that's the whole vibe. ✨
  • --collection COLLECTION, -c COLLECTION — the directory where the collection will be initialized. the default is . (yes, just a dot — current directory, we love a low-effort default). 🍓
  • --no-git — do not use git in the current collection. no repo, no hooks, no staging, just vibes. 🙈

👑 AUTHOR 👑

valhalla@trueelena.org

2020-2021, Elena Grandi

and that's the whole page bestie!! this was version 0.10, dated Jan 29, 2025 — go forth and init something beautiful 💖🌸✨🦋

📦 where this page comes from