/srv/irclogs.ubuntu.com/2015/06/25/#ubuntu-doc.txt

ahoneybunpmatulis_: next meeting is July 7th. :) I would change the topic but I don't have access16:37
=== pmatulis_ is now known as pmatulis
=== dpm_ is now known as dpm
pmatulisahoneybun: did you get my last msg concerning markdown about a week ago?18:21
pmatulisrepeat:18:22
pmatulisahoneybun: concerning using Markdown, ideally GFM (Github Flavored Markdown), for the installation-guide. we need to know if our processes will accept it or not18:22
pmatulisahoneybun: can you look into this?18:22
ahoneybunprocesses?18:23
ahoneybunI did not get that msg18:23
pmatulisahoneybun: have you had the chance to look over how we publish stuff on help.ubuntu.com?18:23
ahoneybunI have not tbh18:24
pmatulisahoneybun: well your idea won't go very far then. specifically, we need to know if LP can handle markdown for managing translations, and if it does, what flavour of markdown18:26
pmatulisahoneybun: i suggest you speak with someone knowledgeable in LP doc translations and explain your idea. there is a translations team, mailing list, etc18:27
ahoneybunI don't even know how LP does it, I can never find the .po/.pot files18:27
ahoneybunI was trying to prototype working with translations last night/this morning18:27
pmatulisahoneybun: that's fine, but we also need to know if LP can handle it18:28
pmatulisahoneybun: the translations aspect always thwarted me in the past when i thought of moving away from XML, maybe you will prove successful. it might be trivially easy, but it may not be18:29
ahoneybunpmatulis: I have the Kubuntu Manual all moved to reST and uploaded to LP so we could prototype it18:30
ahoneybunI have talked with someone over in the Kubuntu camp about using a translation tool called Pootle18:31
pmatulisahoneybun: crux of the matter IMO is: LP can generate the POT file from the master english XML file. hence: can LP do the same from a master Markdown file18:32
ahoneybunthat is the question18:33
pmatulisyep18:33
ahoneybunI'm learning how LP works with translations as we talk so I'm just catching up lol18:33
pmatulisas long as you remember that english is the root of the docs it becomes clearer - english XML -> POT file -> LP handles online translations of strings in POT file -> download PO file (result of translations) for every language -> generate HTML from each PO file18:36
ahoneybunso the po file holds all the translations?18:37
pmatulisfor each language, yes. so there are multiple PO files18:37
ahoneybunI see18:37
ahoneybunso for the current idea: english reST -> POT file -> Hope LP handles the translations in POT -> download the PO file -> Sphinx makes html for each PO file18:39
ahoneybunfrom looking at this: http://sphinx-doc.org/intl.html?highlight=translations18:39
ahoneybunsphinx can make POT files so we push them into LP and let it make PO files18:40
ahoneybunrather then Pootle18:40
pmatulisahoneybun: you may want to use sphinx for local tests or POC but ultimately the makefile we use needs to contain the instructions and currently we don't use sphinx. as long as we get updated PO files we should be good. concentrate on the main question above (see 'crux:')18:41
pmatulisand i would prefer GFM flavour of markdown18:42
pmatulisand recall that we are testing the installation-guide first18:42
ahoneybunbut we don't use github18:43
pmatulisahoneybun: it may still be compatible, it is worth asking18:44
ahoneybunI have not messed with using Markdown (in any form) with Sphinx tbh18:45
ahoneybunwell I just made some .po files with Sphinx18:47
ahoneybunsorry pot18:48
ahoneybunpmatulis: http://pastebin.ubuntu.com/11775051/18:50
ahoneybunwhere is the installation guide?18:50
pmatulishttps://launchpad.net/installation-guide18:52
pmatulishttps://help.ubuntu.com/lts/installation-guide/index.html18:52
ahoneybunbzr branch lp:~ubuntu-core-dev/installation-guide/ubuntu ?18:54
pmatulislooks good to me18:57
ahoneybun <sdough> ahoneybun: Looks like that depends on what Markdown parser you use.18:57
ahoneybunI'm in the sphinx-doc irc18:57
pmatulisshould be asking LP people IMO about what capabilities LP has18:59

Generated by irclog2html.py 2.7 by Marius Gedminas - find it at mg.pov.lt!