docs February 2012

docs@lists.stg.fedoraproject.org

22 participants
29 discussions

questions of tx push install guide
by Alick Zhao 13 Feb '12

13 Feb '12

Hi all, When I run 'tx push -s' in the install-guide working tree, I get warning message for each resource like this: (f16>)$ tx push -s Pushing translations for resource fedora-install-guide.Adding_Partitions-section-2-ilist-1-litem-1: You don't seem to have a proper source file mapping for resource fedora-install-guide.Adding_Partitions-section-2-ilist-1-litem-1. Try without the --source option or set a source file first and then try again. The corresponding config in .tx/config is as below: [fedora-install-guide.Adding_Partitions-section-2-ilist-1-litem-1] file_filter = <lang>/Adding_Partitions-section-2-ilist-1-litem-1.po source = pot/Adding_Partitions-section-2-ilist-1-litem-1.pot source_lang = en I suspect that the line begin with 'source =' should be 'source_file =', but I am not sure. Another question: currently there are 871 pot files in f16 branch. It means that there should be 871 resources of install-guide on transifex. But now there are only 51 (from 'tx status' output). How should we set up to allow all pot files to appear on transifex? Besides, Adding_Partitions-section-2-ilist-1-litem-1 and several similar on transifex do not have corresponding pot file in working tree. Anything wrong here? -- alick Fedora 16 (Verne) user https://fedoraproject.org/wiki/User:Alick

3 5

How to deal with bogus entry in DB?
by Alick Zhao 07 Feb '12

07 Feb '12

Hi docs folks, I think I have got a tough jouney to publish zh-CN translation of install guide. In the install-guide working directory, I want to install the book and get these error messages: (f16>)$ publican install_book --site_config ../web/homepage.cfg --lang zh-CN DEBUG: Publican: config loaded ERROR: bogus entry found in DB: zh-TW/Fedora/12/pdf/Installation_Quick_Start_Guide ERROR: bogus entry found in DB: zh-TW/Fedora/12/pdf/Virtualization_Guide Then I cd to my local copy of website dir, look into the directory `publish_html/zh-TW/Fedora/12/`. No pdf subdirectory there indeed, let alone the two guide mentioned in the error messages. I think the fedoradocs.db might need manual fix, so I create a 'fix-db' branch, and manually delete bogus entries in the db: (fix-db)$ sqlite3 fedoradocs.db SQLite version 3.7.7.1 2011-06-28 17:39:05 Enter ".help" for instructions Enter SQL statements terminated with a ";" sqlite> select * from books where language = 'zh-TW' and version = 12 and format = 'pdf' ; sqlite> delete from books where language = 'zh-TW' and version = 12 and format = 'pdf' ; sqlite> .exit After that, a rerun of publican install_book seems fine. So am I right of the manual operation? I have skimmed the list archives and find the similar error reported and later fixed. But I don't know how it was fixed. -- alick Fedora 16 (Verne) user https://fedoraproject.org/wiki/User:Alick

2 5

Meeting summary -- 6 February 2012
by Ben Cotton 06 Feb '12

06 Feb '12

Quiet meeting this week! Meeting summary --------------- * Roll Call (bcotton, 14:00:37) * Follow up on last week's action items (bcotton, 14:03:49) * Release Notes (bcotton, 14:08:45) * LINK: https://fedoraproject.org/wiki/Release_Notes_schedule (bcotton, 14:08:54) * LINK: https://fedoraproject.org/wiki/Documentation_Beats (bcotton, 14:09:11) * Guide Status (bcotton, 14:14:01) * LINK: http://rbergero.fedorapeople.org/schedules/f-17/f-17-docs-tree-tasks.html (bcotton, 14:14:10) * Outstanding BZ Tickets (bcotton, 14:16:20) * LINK: http://tinyurl.com/lbrq84 (bcotton, 14:16:27) * Open floor discussion (bcotton, 14:16:35) Meeting ended at 14:27:24 UTC. Action Items ------------ Action Items, by person ----------------------- * **UNASSIGNED** * (none) People Present (lines said) --------------------------- * bcotton (32) * alick (7) * pkovar (6) * Sparks (5) * suehle (4) * randomuser (3) * zodbot (3) * jjmcd (2) * LoKoMurdoK (1) * jhradilek (1) Minutes: http://meetbot.fedoraproject.org/fedora-meeting/2012-02-06/fedora_docs.2012… Minutes (text): http://meetbot.fedoraproject.org/fedora-meeting/2012-02-06/fedora_docs.2012… Log: http://meetbot.fedoraproject.org/fedora-meeting/2012-02-06/fedora_docs.2012… -- Ben Cotton Fedora Docs Leader

1 0

Fedora Docs Meeting Reminder
by Ben Cotton 05 Feb '12

05 Feb '12

This is an automated message to remind you that we will be meeting at 9 AM EST (1400 UTC) in #fedora-meeting. Unless we've previously agreed that we will not be meeting today.

1 0

Resurrecting mw-render
by Ian Weller 03 Feb '12

03 Feb '12

At FUDCon Blacksburg, Sparks, jjmcd, and I determined that mw-render no longer provides a DocBook writer and therefore it would be stupid to try and repackage it. This week I found out that was still true, but instead of completely deleting code, they decided to move the DocBook renderer (and its required XHTML renderer) in a separate Python package. Here is the status of getting everything we need back into Fedora: https://fedoraproject.org/wiki/User:Ianweller/mwlib_status However, before I go too crazy, I wanted to present the current SRPMs that I have now so that you guys can test and make sure python-mwlib is still something we can use in Docs. At this point I will freeze these SRPM releases, so if I make a new one there will also be a corresponding release bump and a changelog entry. http://ianweller.fedorapeople.org/SRPMS/python-mwlib/0.13.3-1/ http://ianweller.fedorapeople.org/SRPMS/python-mwlib-docbook/0.1.0-1/ http://ianweller.fedorapeople.org/SRPMS/python-mwlib-xhtml/0.1.0-1/ http://ianweller.fedorapeople.org/SRPMS/python-qserve/0.2.6-1/ Additional packages you will need: https://admin.fedoraproject.org/updates/python-bottle-0.10.7-1.fc16 https://bugzilla.redhat.com/show_bug.cgi?id=786668 Everything else should already be in Fedora. (TODO: It was brought to my attention that apipkg is bundled in python-py and there is an actual upstream project which is supposed to be packaged separately. I'm going to see about reviewing that, then filing a bug against python-py to unbundle their copy of apipkg. And then fixing python-mwlib again.) -- Ian Weller <ian(a)ianweller.org>

2 2

Re: mwlib work
by Ian Weller 03 Feb '12

03 Feb '12

On Fri, Feb 03, 2012 at 05:59:00PM +0100, Nicola Soranzo wrote: > Il giorno ven, 03/02/2012 alle 09.47 -0600, Ian Weller ha scritto: > > On Fri, Feb 03, 2012 at 02:44:55PM +0100, Nicola Soranzo wrote: > > > - python-apipkg, review request https://bugzilla.redhat.com/652034 > > > > Just looked a little bit more and it looks like python-py is bundling > > this from upstream, and that's not okay either :) So I'll add that > > review request to the list and also note that I need to submit a bug > > against python-py to unbundle apipkg. > > It looks like that both apipkg and py are maintained by the same guy > (Holger Krekel): > > http://bitbucket.org/hpk42/apipkg > https://bitbucket.org/hpk42/py > > apipkg is probably just a subset of py. I'm going to ask upstream if apipkg is updated properly in py, and then ask the python-py maintainer to add a Provides: python-apipkg. And then close the python-apipkg review request assuming that all goes through just fine. Or maybe I'll ask FPC. (This is stupid.) -- Ian Weller <ian(a)ianweller.org>

2 1

Questions about install guide
by Alick Zhao 02 Feb '12

02 Feb '12

Hi all, I want to help publishing zh_CN version of Fedora Installation Guide. I have some questions. [1] says that I should join gitinstall-guide group. I am not sure this is required because I just see four members in this group and no one is approved. In the page [1], the last but one link 'statistics page' points to the outdated translate.fp.o url [2]. Can anyone update it? The po files on transifex are not complete. There are only some resources beginning with the character A. [3] Is that intended, or kind of a bug? [1]: https://fedorahosted.org/install-guide/ [2]: http://translate.fedoraproject.org/module/docs-install-guide [3]: https://www.transifex.net/projects/p/fedora-install-guide/ -- alick Fedora 16 (Verne) user https://fedoraproject.org/wiki/User:Alick

2 3

Resource Management Guide repository changes
by Jaromir Hradilek 02 Feb '12

02 Feb '12

Dear writers, To make the location of repositories for our books consistent, the Git repository for the Fedora Resource Management Guide has been moved from its previous location and can now be found here: http://git.fedorahosted.org/git/?p=docs/resource-management-guide.git If you already have a clone of the repository on your disk, you will not be able to pull or push any changes unless you update the URL. To do so, get into the working directory, open the .git/config file in a text editor of your choice, and find the following line: url = ssh://<fas_login>@git.fedorahosted.org/git/resource-management-guide.git ...where <fas_login> is your FAS username. Now update the URL to look like this: url = ssh://<fas_login>@git.fedorahosted.org/git/docs/resource-management-guide.git Many thanks to nb for moving this repo where it should have been in the first place. Cheers, -- Jaromir Hradilek Associate Content Author Engineering Content Services Red Hat Czech, s. r. o. Purkynova 99 612 45 Brno, Czech Republic

1 0

Updated lang codes
by Petr Kovar 02 Feb '12

02 Feb '12

Hi list, There are some new languages registered on fedora.transifex.net, so we need to update the .tx/config file in our guides again. The updated list of lang codes is available at: https://fedoraproject.org/wiki/Setting_up_a_document_with_Transifex#Step_5:… Guide owners, please update your tx/config file before running tx pull. Cheers, Petr Kovar

1 0

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs February 2012