There is a very good tutorial on XLSFORM design at http://xlsform.org/. Unfortunately, it is not available in pdf format for offline study. I have therefore prepared a structured (with table of contents) pdf of this tutorial.
I am uploading it here in case it can be helpful for some of the forum users.XLSFORM tutorial_edSouirji.pdf (956.1 KB).
Naturally, the authors of the original work http://xlsform.org/ deserve all the credit.
Hi @yanokwa,
It is possible to produce a pdf from most web pages in Mozilla Firefox. While the web page is opened, click File/Ok wait for the pdf to be prepared then, in the windows browser that opens, give it a name and choose the folder to save it.
I'm sorry I didn't realize you're asking about possible tools to be made available for use in ODK's Docs website. Does this website already exist and if yes, can you kindly provide a link?
Thank you so much; how comes I haven't seen this before???
I have just had a first quick look. This docs website is very well-designed and useful. Thumbs up to the authors.
And yes it would be great to add pdf and epub export functionality.
I did, because Documentation is buried in the Development category which is mostly visited by people involved in software development activities; a (very useful) minority in this forum.
I kindly propose that Documentation be a category in its own right because its scope goes far beyond software development; it's the first place to visit for all ODK users! Upgrading Documentation to a full category status will give it more visibility.
Thanks for all the kind words and support. We've been working hard to transfer docs, rewrite docs, and write new docs. We still have a lot of work to do, but it's coming along -- thanks especially to the Outreachy applicants, who have really sped up the work over the last month or so.
I have opened an issue to talk about PDF export. I have some concerns about doing so -- we don't want to encourage the proliferation of outdated documentation -- but it is definitely a possibility. EPUB as well... doable, but I do wonder about the potential problems.
If we're interested in an offline copy, this would be my highest preference, as we could make sure it updated when people were online with their devices.
Thanks for your great work and thoughtful remarks. I do understand your concerns about people using outdated PDF and ePUB docs. However, from experience I worry even more about people in the developing world not being able to stay online to read and work with lengthy documents. Indeed, Internet connections are often unreliable and very costly.
I would suggest to use the method of QGIS documentation; you can either read the documents (user guide or training manual) online as HTML file or download a PDF file which always includes the date (of the download) on the front page. This way it's the user's business to get regularly updated.
I see your point on this but I wonder whether creating a new category is the right approach. I think what's missing is a link to the docs themselves from the main ODK website so that users easily find them. The reason that isn't there yet is because there are still some key resources missing from docs. As soon as they're up, links will be updated.
This documentation forum category is for discussion about developing the docs, not really for users to find the docs.
I propose that we work to get the docs site to a place where it can be linked from the main ODK website and get redirects up for each documentation page on the website AND get an announcement post out soon highlighting the existence of the doc. Announcement posts are emailed to all forum subscribers so I think that will help give them visibility. How does that sound, @Souirji_Abdelghani?
Thank you for your thoughtful comments. I agree with your comments and proposed solution for forum users to easily locate and access ODK documentation.