Website of the Vala programming language. View the website here: https://vala.dev
You can contribute to the new documentation website here: https://github.com/vala-lang/vala-docs
Feel free to create a new issue or participate in an existing one
- Bun (version 1.1 or newer)
Bun is the only required toolchain; it bundles the package manager, the runtime, and the task runner used by this project.
Install the dependencies:
bun installStart the development server:
bun run devThen open the website in your browser at http://127.0.0.1:5173.
Other scripts:
bun run build # produce a static site in .vitepress/dist (and generate atom.xml)
bun run preview # preview the built site locally
bun run format # run prettier on the codebase- Fork this repository.
- Translate the strings in
.vitepress/locales/<language>.js. Start from.vitepress/locales/en.jsand keep the same keys. Helpful references: - For markdown pages (the home page, About, blog posts), create a translated copy under the matching locale folder, e.g.
cs/about/index.mdfor Czech,fr/blog/my-post.mdfor French. - Register the locale (if new) in
.vitepress/locales/index.jsand in thelangAttrmap in.vitepress/config.mjs. - Create a pull request with the changes you've made.
Important Notes:
- You must translate the About page and the Home page.
- When translating
.vitepress/locales/<language>.js, copy the English file first and replace each string over time. - Feel free to ask for help. You can ask in the issue you created or on the discussions page.
-
Create a new markdown file under
blog/(or under<locale>/blog/for a translated post), for exampleblog/my-post.md. The filename becomes the URL slug. -
Add YAML front matter at the top of the file. The required fields are:
--- layout: post title: My Post description: A short summary used in metadata and on the blog index. date: "YYYY-MM-DD" authors: - Your Name ---
-
Write the post body in markdown underneath the front matter.
-
Create a pull request with the changes you've made.
For more information, check out the "pages" section of the contributor guide.
Check out the contributor guide to learn more about how this website works.
Various people have contributed to this website in some way and, more people will also help with the project over time.
The Contributors section in the GitHub repository doesn't tell the whole story. There's a file called humans.txt (available in /public/humans.txt) where contributor details can be added.
Feel free to request for your details to be added or add them yourself if you have contributed to this project in any way. This is available for anyone to see if they visit: https://vala.dev/humans.txt.
You can find out more about humans.txt at: https://humanstxt.org/.