GSoC/2020/StatusReports/Shubham: Difference between revisions

From KDE Community Wiki
< GSoC‎ | 2020‎ | StatusReports
No edit summary
No edit summary
Line 1: Line 1:
== Integrated Documentation ==
== Integrated Documentation ==
At the moment the external documentation like for example for Maxima http://maxima.sourceforge.net/docs/manual/en/maxima.html, and similar for Octave, python, etc., is opened in the external browser window. Ideally, it should be shown inside of the application in the help/documentation panel and enable a quick access to the documentation together with some more advanced search capabilities. Integrated search and also the context sensitive help (user marks a keyword in the worksheet, hits e.g. the F1 button and the documentation for the selected keyword is shown) should be possible. Qt Help Framework (http://doc.qt.io/qt-5/qthelp-framework.html) should be utilized for this. For indexing and searching in a unified manner the documentation together with the search index should be available locally. Qt help's qch file should be available for download on store.kde.org. Users of different systems (Maxima, Octave, R, etc.) would download the documentation they need. Ideally, there should be similar appearance of documentations by css-styling the html files for different systems prior to creating those qch files.  
At the moment the external documentation like for example for Maxima http://maxima.sourceforge.net/docs/manual/en/maxima.html, and similar for Octave, python, etc., is opened in the external browser window. Ideally, it should be shown inside of the application in the help/documentation panel and enable quick access to the documentation together with some more advanced search capabilities. Integrated search and also the context-sensitive help (user marks a keyword in the worksheet, hits e.g. the F1 button and the documentation for the selected keyword is shown) should be possible. Qt Help Framework (http://doc.qt.io/qt-5/qthelp-framework.html) should be utilized for this. For indexing and searching in a unified manner the documentation together with the search index should be available locally. Qt help's qch file should be available for download on store.kde.org. Users of different systems (Maxima, Octave, R, etc.) would download the documentation they need. Ideally, there should be a similar appearance of documentations by CSS-styling the HTML files for different systems prior to creating those qch files.  


==Project Goals==
==Project Goals==
Line 9: Line 9:
* Context sensitive help support
* Context sensitive help support
** Status: '''Done'''
** Status: '''Done'''
* Topic based searching
* Keyword based searching
** Status: '''Pending'''
** Status: '''Done'''
* Toolbar with Zooming, Find in page text, Go Home widget
** Status: '''Done'''
* Downloading availablity for images/pages
** Status: '''Done'''
* Availability of qch files over KDE store
* Availability of qch files over KDE store
** Status: '''Pending'''
** Status: '''Pending'''


==Month 1 (June 1 - July 3)==
==Month 1 (June 1 - July 3)==
During the first half of the period, I have created Qt help files namely qch and qhc from the Maxima's source code for it's documentation. I have added some custom styling to it as well. In the second half of the coding period, I was busy writing code to implement a dedicated documentation panel which would display the relevant help to the user. I have also successfully implemented context sensitive search capabilities inside the worksheet for Maxima backend. [https://invent.kde.org/education/cantor/-/commits/gsoc20_documentation This] page lists all the commits made so far. To get more detailed information, consider going through the blog post listed below.
During the first half of the period, I have created Qt help files namely qch and qhc from Maxima's source code for its documentation. I have added some custom styling to it as well. In the second half of the coding period, I was busy writing code to implement a dedicated documentation panel which would display the relevant help to the user. I have also successfully implemented context-sensitive search capabilities inside the worksheet for Maxima backend. To get more detailed information, consider going through the blog post listed below.
==Month 2 (July 4 - July 31)==
==Month 2 (July 4 - July 31)==
In the second month of the coding period, I have various tasks. I have added a toolbar with widgets like "Searching through keywords", "Resetting zoom level", "Find in Page text" and "Home" widgets. These widgets does the tasks their name suggests. "Search though keywords" is a widget  where user can type in the keyword they are trying to get help for and then get its documentation. It has a completer which makes it easier for the user to find help for the intended keyword. I had also added other functionalities like zooming in-out and resetting the zoom-level to 100%. Another thing that I have added is the ability to download embedded images/gif or the HTML pages from the documentation.


==Month 3 (August 1 - August 31)==
==Month 3 (August 1 - August 31)==
Line 25: Line 30:
== My Branch ==
== My Branch ==
https://invent.kde.org/education/cantor/-/tree/gsoc20_documentation
https://invent.kde.org/education/cantor/-/tree/gsoc20_documentation
== Commits ==
https://invent.kde.org/education/cantor/-/commits/gsoc20_documentation


== Contact Me ==
== Contact Me ==

Revision as of 14:12, 27 July 2020

Integrated Documentation

At the moment the external documentation like for example for Maxima http://maxima.sourceforge.net/docs/manual/en/maxima.html, and similar for Octave, python, etc., is opened in the external browser window. Ideally, it should be shown inside of the application in the help/documentation panel and enable quick access to the documentation together with some more advanced search capabilities. Integrated search and also the context-sensitive help (user marks a keyword in the worksheet, hits e.g. the F1 button and the documentation for the selected keyword is shown) should be possible. Qt Help Framework (http://doc.qt.io/qt-5/qthelp-framework.html) should be utilized for this. For indexing and searching in a unified manner the documentation together with the search index should be available locally. Qt help's qch file should be available for download on store.kde.org. Users of different systems (Maxima, Octave, R, etc.) would download the documentation they need. Ideally, there should be a similar appearance of documentations by CSS-styling the HTML files for different systems prior to creating those qch files.

Project Goals

  • Creation of Qt help files for Maxima (qch and qhc)
    • Status: Done
  • Dedicated Documentation panel
    • Status: Done
  • Context sensitive help support
    • Status: Done
  • Keyword based searching
    • Status: Done
  • Toolbar with Zooming, Find in page text, Go Home widget
    • Status: Done
  • Downloading availablity for images/pages
    • Status: Done
  • Availability of qch files over KDE store
    • Status: Pending

Month 1 (June 1 - July 3)

During the first half of the period, I have created Qt help files namely qch and qhc from Maxima's source code for its documentation. I have added some custom styling to it as well. In the second half of the coding period, I was busy writing code to implement a dedicated documentation panel which would display the relevant help to the user. I have also successfully implemented context-sensitive search capabilities inside the worksheet for Maxima backend. To get more detailed information, consider going through the blog post listed below.

Month 2 (July 4 - July 31)

In the second month of the coding period, I have various tasks. I have added a toolbar with widgets like "Searching through keywords", "Resetting zoom level", "Find in Page text" and "Home" widgets. These widgets does the tasks their name suggests. "Search though keywords" is a widget where user can type in the keyword they are trying to get help for and then get its documentation. It has a completer which makes it easier for the user to find help for the intended keyword. I had also added other functionalities like zooming in-out and resetting the zoom-level to 100%. Another thing that I have added is the ability to download embedded images/gif or the HTML pages from the documentation.

Month 3 (August 1 - August 31)

Link to my blog

https://coderunner20.blogspot.com/

My Branch

https://invent.kde.org/education/cantor/-/tree/gsoc20_documentation

Commits

https://invent.kde.org/education/cantor/-/commits/gsoc20_documentation

Contact Me

Email: [email protected]

IRC: shubham1000

Github Profile: https://github.com/Shubham-100

Gitlab Profile: https://invent.kde.org/shubham