feat: add custom CSL for bibliography

README.md

@@ -16,7 +16,9 @@ This template:
 This template:
 - Sets up document styles;
 - Formats the title, task, calendar plan, and abstract pages;
-- Typesets the bibliography, outline, and appendices according to standard requirements.
+- Typesets the bibliography according to ДСТУ 3008:2015 using custom CSL style;
+- Typesets the outline and appendices according to standard requirements.
+
 
 ### Utilities
 - `nheading` - For unnumbered headings, such as "Introduction" and "Conclusion".
@@ -122,6 +124,34 @@ semester = 4
 1. Use `#v(-spacing)` to remove vertical spacing between titles (this cannot be automatically handled by the template). Variable `spacing` used here is imported from the template.
 2. When importing `@local/nure:0.1.0` and specifying file paths in functions handled by the package, the path will relative to package's root directory, e.g. setting `#show: coursework.with(bib_path: "bibl.yml")` will evaluate to `~/.local/share/typst/packages/local/nure/0.1.0/bibl.yml`, the same is for `#img` function, which makes it quite annoying and forces one to import `lib.typ` file. Please open an issue or contact us in any other way if you have any advice.
 
+### Bibliography Format
+The template uses a custom CSL (Citation Style Language) file located at `src/csl/dstu-3008-2015.csl` to format bibliography entries.
+
+Supported bibliography entry types in `bibl.yml`:
+- **Book**: Books with author, title, publisher, year, and page count
+- **Web**: Web resources with title, author/organization, URL, and access date
+
+**Warning:** Other types were added by Kimi K2.5 without any additional checks for compliance.
+
+Example `bibl.yml`:
+```yaml
+mysql:
+  type: Book
+  title: MySQL Language Reference
+  author: Ab M.
+  publisher: MySQL Press
+  date: 2004
+  page-total: 600
+
+go:
+  type: Web
+  title: The Go Programming Language
+  author: The Go Programming Language
+  url:
+    value: https://go.dev/
+    date: 2024-12-10
+```
+
 ### Example Project Structure
 ```
 project/