Calling for Server Guide reviewers/contributors - - TRUSTY

[Tom Davies]

Hi :)
Sorry i can't help!

I'm guessing you have already have good work-flows but one thing that
only occurred to me fairly recently was to use "search and replace" to
fix all the links fairly quickly.  For my company's website i had to
copy&paste the html into a text-editor.  Also it worked because all
the links had changed in a very similar way and then just 1 or 2 had
to be tweaked.  It might well not be viable in this case but for me it
was a huge help

Apols and regards from
Tom :)





On 3 January 2014 06:08, Mauricio Tavares <raubvogel at gmail.com> wrote:
> On Fri, Jan 3, 2014 at 5:58 AM, Peter Matulis
> <peter.matulis at canonical.com> wrote:
>> On 01/02/2014 03:52 PM, Tom Davies wrote:
>>> Hi :)
>>> I quite liked it's simplicity but is it possible to move the "Quick
>>> Search" feature to the top of the column (on the right) rather than
>>> leaving it at the bottom?
>>>
>>> The contents lists are quite long so people probably don't instantly
>>> realise the functionality exists.  Also putting it at the top-right
>>> would make it more consistent with other wiki's wouldn't it?  (err, i
>>> don't know now since i haven't checked for ages!)
>>>
>>> Anyway, good work so far!
>>> Congrats and regards from
>>> Tom :)
>>>
>>>
>>>
>>> On 2 January 2014 18:36, Mauricio Tavares <raubvogel at gmail.com> wrote:
>>>> On Thu, Jan 2, 2014 at 6:13 PM, Peter Matulis
>>>> <peter.matulis at canonical.com> wrote:
>>>>> On 12/13/2013 01:25 AM, William Van Hevelingen wrote:
>>>>>> Yeah...looks like those didn't get converted. It shouldn't be that much
>>>>>> effort to fix all the headers. The internal links will have to be fixed
>>>>>> too, maybe a sed script can fix them up.
>>>>>>
>>>>>> I used sphinx to generate some html and posted it here:
>>>>>>
>>>>>> http://web.cecs.pdx.edu/~wvan/serverguide/remote-administration.html
>>>>>>
>>>>>> Not really sure how to make the index/homepage work yet but this is a
>>>>>> work in progress. :)
>>>>>>
>>>>>> Do you have any feedback so besides the other items you mentioned?
>>>>>>
>>>>>> Btw `make lintcheck` is awesome. It reports on all the broken external
>>>>>> links and we can hook it up to continuous integration.
>>>>>
>>>>> Here is my own attempt, including some branding.  Feedback welcome.
>>>>> Yes, there are still broken links and the table of contents is too
>>>>> expansive.  I really like the streamlined markup (see 'Show Source' at
>>>>> the bottom of the TOC).
>>>>>
>>>>> http://serverguide.papamike.ca:8081
>>>>>
>>>>        I think it looks nice; I do like simple clean interfaces so you
>>>> can focus on content. How many header levels can you have with it?
>>>>
>>>> With that in mind, now I have some free time I personally want to
>>>> figure out my ssh key issue and then populate some of the docs. For
>>>> that, I do not care about whatever format we choose; just make sure we
>>>> can convert from the current to the new style with as little pain as
>>>> possible.
>>>>
>>>> In the mean time, I can work and flesh out my notes until I can start
>>>> working on those docs. I would like to be able to sit down on the
>>>> weekend and get stuff done. Ideally one topic per weekend.
>>
>> After having spent a good part of the day going through just one file
>> (chapter) I now know how much work is involved:
>>
>> 1. A good number of external links are broken
>> 2. All internal links are broken and require a new way of linking
>> (source and destination)
>> 3. All admonitions (i.e. "notes" and "warnings") are crippled, but not
>> outright broken
>> 4. All working external links *should* be changed to a new format
>> 5. Heading organization need to be redone in all chapters.  All chapters
>> have multiple 1st level headings.  This is what was causing the
>> flattened/expansize table of contents I mentioned earlier.
>> 6. More theme/customization work
>> 7. Research how this conversion will affect the translators and come up
>> with a corrective plan
>>
>> I can't do all this myself; I estimate there is about 120 hours of work
>> required.  Anyone?
>>
>       I can help; it would be a good way to understand the new format.
> Should I do what you did and fetch a chapter somehow, edit it and
> place it somewhere so it can be seen before brought back?
>
>> pmatulis
>>
>> --
>> ubuntu-doc mailing list
>> ubuntu-doc at lists.ubuntu.com
>> https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
>
> --
> ubuntu-doc mailing list
> ubuntu-doc at lists.ubuntu.com
> https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc