FreeBSD Documentation Portal status and review request
- Reply: Rocky Hotas : "Re: FreeBSD Documentation Portal status and review request"
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Sun, 21 Nov 2021 16:31:18 UTC
Dear FreeBSD community, A couple of months ago we added information about the new FreeBSD Documentation Portal to the quarterly reports. Well, at this time there's some things that need to be accomplished in the new Documentation Portal. For example a local search using Algolia as Hugo or AsciiDoctor does. Algolia provides a free version for Open Source projects. And the dark theme. Apart from that, you can see the new Documentation Portal here. I used my personal VPS to deploy the documentation portal temporarily to show to the community since I have problems with Gitlab and Docker. I didn't add all the languages because the bandwidth and the disk size is very limited. I have the cheapest VPS in Digital Ocean hehe. To summarize the changes you are going to find: - Completely new responsive design. Tested in FreeBSD and all other major OS. - Removed Python from the dependencies. - Removed the list of figures, tables and examples. Do you think these lists are useful? In this case I'll restore it using the AsciiDoctor API instead of Python. This change will not be as traumatic as the previous one, it will not be necessary to freeze the repository or change the technology used to build the documentation. The existing theme will "just" be modified. Please let me know your thoughts about this :) I'm gonna send this message to the documentation and translators list to reach more people. The next steps will be: - Finish the dark theme (1 more week) - Implement Algolia to use it for local searches (1 more week) - Use mandoc to generate the manual pages - Redesign the ports page - Redesign of the FreeBSD main website Bye!  https://www.freebsd.org/status/report-2021-07-2021-09/#_freebsd_website_revamp_webapps_working_group  https://www.algolia.com  https://gohugo.io/  https://docs.asciidoctor.org/home/  https://www.algolia.com/for-open-source/  https://carlavilla.es