📚 Doc: Add detailed documentation for the templates guide

grivera64 commented 3 weeks ago

Maintenance Task Description

This issue proposes to provide more snippets of ways to use templates in Go Fiber’s templates guide.

This would include adding information on how to:

Render dynamic html content (e.g. convert string into html)
Iterate through arrays/slices/map in templates
Any other common use cases for templates

Impact on the Project

Adding more detailed documentation of common use cases will help make Go Fiber easier to adopt for newcomers interested in using templates. While guides on templates can be found on other websites, providing this information within GoFiber’s own docs will make it easier to get started.

Adding this might require re-ordering the headings within the gofiber.io templates guide to avoid cluttering the page, but we can follow the format of similar pages (view additional context).

Additional Context (optional)

The goal is to have a more detailed guide for templates like in the routing guide:

https://docs.gofiber.io/guide/routing

Thank you for your time and consideration.

Checklist:

[X] I have confirmed that this maintenance task is currently not being addressed.
[X] I understand that this task will be evaluated by the maintainers and prioritized accordingly.
[X] I am available to provide further information if needed.

efectn commented 2 weeks ago

Feel free to create a PR. I agree with you, we need more detailed guides for templates. We can add common usecases into templates section and specific usecases to template itself

grivera64 commented 2 weeks ago

Sounds good! I made a draft PR to work on this issue.

I am currently working on adding a few advanced use cases, (such as using engine.AddFunc()). We can also consider adding the use cases featured in the gofiber/template README.md, though we should only include generic features provided by all template engines.

grivera64 commented 2 weeks ago

I also added a link to the gofiber/template GitHub repository to help guide newcomers to find engine-related code.

I believe the PR is ready to be pulled, please let me know if I should make any changes or if you have any recommended additions.

grivera64 commented 2 weeks ago

Thanks @ReneWerner87 for merging my pull request to v2 and adapting it for v3! Marking this issue as completed.

gofiber / fiber