SoK/2021/StatusReport/Pablo Marcos

From KDE Community Wiki
Revision as of 09:51, 8 March 2021 by Flyingflamingo (talk | contribs) (Created first status report)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

New Website for Okular

Background

Okular is a multifaceted program that I use almost every day for my PDF reading and annotating needs, although it can do much more. Sadly, its website is a bit outdated and not mobile friendly. I thus proposed to rewrite the Okular website using the HUGO framework, in a similar way as was done with the kde.org main website, keeping consistency with other KDE applications such as https://konsole.kde.org/. Fortunately, some work was already initiated by Carl Schwan, so I only needed to continue and finish his work.

Mentors

Links

Repositories

Work Done

February 2021

I started by porting the Anouncements section from Raw HTML to Markdown, for which I wrote a small script. Then, I configured the project to use the aether-sass (kde's HUGO standard theme) as a Go module, as Git submodules were less desirable. Finally, I added a FAQ section, which was easy since most questions had been removed from the FAQ in a recent cleanup. For this, I used the </details> and </summary> HTML labels, which I didnt know about and which seem super cool to me.

March 2021

See WIP section

Work in Progress

I am currently working on the /download and /build-it pages. I wrote a HTML mockup, and am in the process of transitioning to a HUGO markdown and HTML templae format.


What I've learnt so far

  • The HTML labels </details> and </summary> exist! This has been super useful, as I have already used that knowledge in some personal projects :p
  • How to use HUGO in general

Contact

If you want to make suggestions in this project do contact me.

Pablo Marcos

Matrix :- @pablitouh:matrix.org