[Openstack-docs] removing italics in documentation listing

Nermina Miller nerminamiller at gmail.com
Tue Oct 29 14:53:57 UTC 2013


The IBM Style Guide uses italics for book titles. Also, for readme files
and release notes. It's a pretty universal style spec. - Nermina


On Tue, Oct 29, 2013 at 9:11 AM, Anne Gentle
<annegentle at justwriteclick.com>wrote:

> Yes, the point is to mark it up meaningfully (those are titles, they are
> being cited). What would you prefer instead of italics? What does the IBM
> Style Guide indicate as correct?
>
> Anne
>
>
> On Tue, Oct 29, 2013 at 8:07 AM, Diane Fleming <
> diane.fleming at rackspace.com> wrote:
>
>> Yes, the xslt would be the place to change that, but I agree with Steve:
>> How do you want to format those?
>>
>> We could do something like:
>>
>> See the <citetitle>Guide to the Stars</citetitle> (<link
>> xlink:href="xxxxx"/>).
>>
>>
>> Diane
>> ----------------------------------------------
>> Diane Fleming
>> Software Developer II - US
>>
>> diane.fleming at rackspace.com
>> Cell  512.323.6799
>> Office 512.874.1260
>> Skype drfleming0227
>> Google-plus diane.fleming at gmail.com
>>
>>
>>
>>
>>
>>
>> On 10/29/13 7:16 AM, "Steve Gordon" <sgordon at redhat.com> wrote:
>>
>> >----- Original Message -----
>> >> From: "Christian Berendt" <berendt at b1-systems.de>
>> >> To: Openstack-docs at lists.openstack.org
>> >> Sent: Tuesday, October 29, 2013 3:39:37 AM
>> >> Subject: [Openstack-docs] removing italics in documentation listing
>> >>
>> >> Hello together.
>> >>
>> >> I just opened https://review.openstack.org/#/c/54243/ to remove the
>> >> citetitles in the documentation listing at
>> >>
>> >>
>> http://docs.openstack.org/image-guide/content/app_community_support.html,
>> >> because
>> >> I don't like that the links in the listing are italic.
>> >>
>> >> Tom mentioned that this is not the right way to simply remove the
>> >> citetitles and that I should start a new thread right here.
>> >>
>> >> How can the italics are removed without removing the citetitles?
>> >>
>> >> Christian.
>> >
>> >In the XSL/CSS applied to the XML by clouddocs-maven I would guess, what
>> >alternative rendering would you intend to apply to citetitle tags instead
>> >of italics though?
>> >
>> >Thanks,
>> >
>> >Steve
>> >
>> >_______________________________________________
>> >Openstack-docs mailing list
>> >Openstack-docs at lists.openstack.org
>> >http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>>
>>
>> _______________________________________________
>> Openstack-docs mailing list
>> Openstack-docs at lists.openstack.org
>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>>
>
>
>
> --
> Anne Gentle
> annegentle at justwriteclick.com
>
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
>


-- 
Thank you!

Nermina Miller
Tech Writer and Editor
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20131029/c0260799/attachment.html>


More information about the Openstack-docs mailing list