SoK/2021/StatusReport/Pablo Marcos: Difference between revisions

From KDE Community Wiki
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
=== New Website for Okular  ===
=== New Website for Okular  ===
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/ Konsole]. Fortunately, some work was already initiated by Carl Schwan, so I only needed to continue and finish his work.
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/ Konsole]. Fortunately, some work was already initiated by Carl Schwan, so I only needed to continue and finish his work.


==== Mentors ====
==== Mentor ====


* [https://invent.kde.org/carlschwan/ Carl Schwan]
* [https://invent.kde.org/carlschwan/ Carl Schwan]


==== Links ====
==== Repo Links ====
 
Repositories
* [https://invent.kde.org/websites/okular-kde-org/ Official Repo where all work will be merged]
* [https://invent.kde.org/websites/okular-kde-org/ Official Repo where all work will be merged]
* [https://invent.kde.org/carlschwan/okular-kde-org/-/tree/work Working Repo]
* [https://invent.kde.org/carlschwan/okular-kde-org/-/tree/work Working Repo]
Line 19: Line 18:
===== February 2021  =====
===== February 2021  =====


I started by [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/e3e8529ff33be74ea4d9ed59406fdef4e5418127 porting the Anouncements section from Raw HTML to Markdown], for which I wrote a small script. Then, I [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/9229e022294accb9b279d87f3d91fb1693251a61 configured the project] to use the [https://invent.kde.org/websites/aether-sass aether-sass] (kde's HUGO standard theme) as a Go module, as Git submodules were less desirable. Finally, I added [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/62829821d073506f15e46def4d0f1418ec215834 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. Finally, [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/7b85b02878982032487e49058771c9685c39b213 I added the new  /download and /build-it pages], using a mixture of HUGO markdown and raw html templates.
I started by [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/e3e8529ff33be74ea4d9ed59406fdef4e5418127 porting the Anouncements section from Raw HTML to Markdown], for which I wrote a small script. Then, I [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/9229e022294accb9b279d87f3d91fb1693251a61 configured the project] to use [https://invent.kde.org/websites/aether-sass aether-sass] (kde's HUGO standard theme) as a Go module, as Git submodules were less desirable. Finally, I added [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/62829821d073506f15e46def4d0f1418ec215834 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. Finally, [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/7b85b02878982032487e49058771c9685c39b213 I added the new  /download and /build-it pages], using a mixture of HUGO markdown and raw html templates.


===== March 2021 =====
===== March 2021 =====


Having added the index page as a raw html template, now I needed to add i18n support; [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/a042f38d0fe1d781860a0056721e66349393b997 this was achieved by using the <nowiki>{{i18n}}</nowiki> HUGO template], which I also used in the /applications table of supported formats. Next, [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/0e7989a171c36f2d7d0b32332a43a490a27ccf59 I added the /contact page], which I redesigned and updated to include matrix. [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/1795c0da36113ee0219a69d66bfce1595218f94c I modified the index] to include a refference to Okular's [https://invent.kde.org/graphics/okular/-/merge_requests/296 upcoming PDF signing support] (¡so neat! I might finally stop using [https://github.com/ctt-gob-es/clienteafirma Autofirma]), [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/9cab0470f744252ecff9ef9721f71de084167dfb cleaned up unnecesary files that were left from the transition], [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/05ce2a78d2b77d4e4e4e19e64a7e3601856095bf and added a Site Search] functionality [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/01d76a0403681263c991b55667f038db80323f3c that works] client-side and does not depend on google, insipired by (some might say ''copied'' ''from'' / en los mentideros dirán que ''copiado de'') [https://gist.github.com/eddiewebb/735feb48f50f0ddd65ae5606a1cb41ae eddieweb's popular gist].
Having added the index page as a raw html template, now I needed to add i18n support; [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/a042f38d0fe1d781860a0056721e66349393b997 this was achieved by using the <nowiki>{{i18n}}</nowiki> HUGO template], which I also used in the /applications table of supported formats. Next, [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/0e7989a171c36f2d7d0b32332a43a490a27ccf59 I added the /contact page], which I redesigned and updated to include matrix. [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/1795c0da36113ee0219a69d66bfce1595218f94c I modified the index] to include a refference to Okular's [https://invent.kde.org/graphics/okular/-/merge_requests/296 upcoming PDF signing support] (¡so neat! I might finally stop using [https://github.com/ctt-gob-es/clienteafirma Autofirma]), [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/9cab0470f744252ecff9ef9721f71de084167dfb cleaned up unnecesary files that were left from the transition], [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/05ce2a78d2b77d4e4e4e19e64a7e3601856095bf and added a Site Search] functionality [https://invent.kde.org/carlschwan/okular-kde-org/-/commit/01d76a0403681263c991b55667f038db80323f3c that works] client-side and does not depend on google, insipired by (some might even say ''copied'' ''from'') [https://gist.github.com/eddiewebb/735feb48f50f0ddd65ae5606a1cb41ae eddieweb's popular gist].


===== April 2021 =====
===== April 2021 =====
I have finished the work on the project. All that is left is some minor modifications and writing this project report.
I have finished the work on the project. All that is left is [https://invent.kde.org/websites/okular-kde-org/-/merge_requests/4 some minor modifications] and writing this project report.
 
==== '''Balance of the Project''' ====
I believe that the [https://season.kde.org/project/46 goals set at the start of the project] (click [https://www.pablomarcos.me/posts/concursos/sok-report-january here] if you dont have a KDE account or wish to see the spanish version) have been mostly fulfilled: the project does in fact present the information in a clear and beautiful, mobile-friendly way, thanks to the aether-sass theme. It has a google-independent in-page search, although it does not use lunar.js as was suggested, and the development news are now in its own section, although the changelogs were left outside of the individual posts for practical reasons. The screenshots and other have been updated, but most of them have been removed as we have decided for a simpler homepage which highlights the most important features of the program.
 
In all, most features in the old webpage have been kept, while adding a more modern redesign which increases usability and makes the project more attractive and coherent with KDE's aesthetic.  


==== What I've learnt so far ====
===== '''What I've learnt''' =====


* The HTML labels </details> and </summary> exist! This has been super useful, as I have already used that knowledge in some personal projects :p
* The HTML labels '''</details>''' and '''</summary>''' exist! This has been super useful, as I have already used that knowledge in my personal webpage :p
* How to use HUGO in general, and HUGO i18n in particular
* How to use HUGO in general, and HUGO i18n in particular
*That Okular is adding PDF Signatures support!
*  That, in my opinion, HUGO is not only much more modular and adaptable than, for example, WordPress, but, for people who know how to use the command terminal, it is even simpler than Wordpress itself
*How to wirte HTML, CSS and JavaScript, important knowledge that I have already applied in my next project, the website for the [https://revista.giepm.com/ Mathematics Journal "Pensamiento Matemático"]
* That Okular is adding PDF Signatures support!
*KDE is as cool as I thought! 😏
* How to wirte HTML, CSS and JavaScript, important knowledge that I have already applied in my next project, the website for the [https://revista.giepm.com/ Mathematics Journal "Pensamiento Matemático"]
* KDE is as cool as I thought! 😏


==== Blog Posts on KDE Planet ====
==== Blog Posts on KDE Planet ====


* Post for January 2021
The links for this blog posts are on my personal site, not on KDE Planet, but you can check they aggregate to Planet by clicking [https://invent.kde.org/websites/planet-kde-org/-/commit/fcd89ac67fc2478f9ad456b1384ccae5f1060d51 here].
* Post for February 2021
 
* Post for March 2021
* [https://www.pablomarcos.me/posts/concursos/sok-report-january/ Post for January 2021]
* Post for April 2021
* [https://www.pablomarcos.me/posts/concursos/sok-report-february/ Post for February 2021]
* [https://www.pablomarcos.me/posts/concursos/sok-report-march/ Post for March 2021]
* [https://www.pablomarcos.me/posts/concursos/sok-report-april/ Post for April 2021]
 
==== Screenshots ====
In order not to supercharge this server, and given the more limited nature of Wiki when it comes to image formatting, I suggest that you check [https://www.pablomarcos.me/posts/concursos/season-of-kde-2021/sok-final-status-report/ the equivalent to this report on my personal blog] in case you want to take a look at the screenshots.


==== Contact ====
==== Contact ====
If you want to make suggestions for this project, please do not hesitate to contact me.
If you want to make suggestions for this project, please do not hesitate to contact me.


[https://invent.kde.org/flyingflamingo Pablo Marcos]
KDE Invent :- [https://invent.kde.org/flyingflamingo Pablo Marcos]


Matrix :- @pablitouh:matrix.org
Matrix :- [https://matrix.to/#/@pablitouh:matrix.org @pablitouh:matrix.org]

Latest revision as of 12:31, 29 March 2021

New Website for Okular

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 Konsole. Fortunately, some work was already initiated by Carl Schwan, so I only needed to continue and finish his work.

Mentor

Repo Links

Work Done

January 2021

I didnt do much in January, as it was the "partiels" (final exams) month at INSA and I was really caught up studying. But, back in Spain, there was a lot of snow! Which is super nice :p

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 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. Finally, I added the new /download and /build-it pages, using a mixture of HUGO markdown and raw html templates.

March 2021

Having added the index page as a raw html template, now I needed to add i18n support; this was achieved by using the {{i18n}} HUGO template, which I also used in the /applications table of supported formats. Next, I added the /contact page, which I redesigned and updated to include matrix. I modified the index to include a refference to Okular's upcoming PDF signing support (¡so neat! I might finally stop using Autofirma), cleaned up unnecesary files that were left from the transition, and added a Site Search functionality that works client-side and does not depend on google, insipired by (some might even say copied from) eddieweb's popular gist.

April 2021

I have finished the work on the project. All that is left is some minor modifications and writing this project report.

Balance of the Project

I believe that the goals set at the start of the project (click here if you dont have a KDE account or wish to see the spanish version) have been mostly fulfilled: the project does in fact present the information in a clear and beautiful, mobile-friendly way, thanks to the aether-sass theme. It has a google-independent in-page search, although it does not use lunar.js as was suggested, and the development news are now in its own section, although the changelogs were left outside of the individual posts for practical reasons. The screenshots and other have been updated, but most of them have been removed as we have decided for a simpler homepage which highlights the most important features of the program.

In all, most features in the old webpage have been kept, while adding a more modern redesign which increases usability and makes the project more attractive and coherent with KDE's aesthetic.

What I've learnt
  • The HTML labels </details> and </summary> exist! This has been super useful, as I have already used that knowledge in my personal webpage :p
  • How to use HUGO in general, and HUGO i18n in particular
  • That, in my opinion, HUGO is not only much more modular and adaptable than, for example, WordPress, but, for people who know how to use the command terminal, it is even simpler than Wordpress itself
  • That Okular is adding PDF Signatures support!
  • How to wirte HTML, CSS and JavaScript, important knowledge that I have already applied in my next project, the website for the Mathematics Journal "Pensamiento Matemático"
  • KDE is as cool as I thought! 😏

Blog Posts on KDE Planet

The links for this blog posts are on my personal site, not on KDE Planet, but you can check they aggregate to Planet by clicking here.

Screenshots

In order not to supercharge this server, and given the more limited nature of Wiki when it comes to image formatting, I suggest that you check the equivalent to this report on my personal blog in case you want to take a look at the screenshots.

Contact

If you want to make suggestions for this project, please do not hesitate to contact me.

KDE Invent :- Pablo Marcos

Matrix :- @pablitouh:matrix.org