Edit
Attach
P
rintable
r19 - 2013-09-25 - 10:51:34 - Main.sbeard
You are here:
TWiki
>
Deployment Web
>
DeploymentGuidanceOnMigratingArticles
<div id="header-title" style="padding: 10px 15px; border-width:1px; border-style:solid; border-color:#FFD28C; background-image: url(<nop>https://jazz.net/wiki/pub/Deployment/WebPreferences/TLASE.jpg); background-size: cover; font-size:120%"> ---+!! Migrating Jazz.net articles to the Deployment wiki %DKGRAY% Authors: Main.RalphEarle, Main.StevenBeard <br> Build basis: None %ENDCOLOR%</div></sticky> <!-- Page contents top of page on right hand side in box --> <sticky><div style="float:right; border-width:1px; border-style:solid; border-color:#DFDFDF; background-color:#F6F6F6; margin:0 0 15px 15px; padding: 0 15px 0 15px;"> %TOC{title="Page contents"}% </div></sticky> <sticky><div style="margin:15px;"></sticky> This article provides guidance for migrating content from Jazz.net articles into the wiki. ---++ Migration procedure 1. Select the article on Jazz.net. Verify that the article source originates on Jazz.net and is not linked from developerWorks or another external source. 1. Open the article on Jazz.net. 1. Copy the article text to the clipboard. *Note:* Copy only the text, and not the HTML tagging. If you copy the HTML tagging, you might introduce inconsistent styles or markup that the wiki does not support. 1. Create a new topic page on the Deployment wiki with the name of the article converted to a !WikiWord. 1. Paste the article text onto the new topic page. 1. If the article contains graphics, follow the steps in [[#MigratingGraphics][Migrating graphics]]. 1. Format the topic page for the wiki. Basic wiki formatting help is shown at the bottom of the page when editing. For details on formatting topic pages and a full list of wiki shorthand, see [[DeploymentFormattingGuidance][Deployment wiki formatting guidance]]. You must add wiki shorthand for the following items in an article: * Headings * Lists * Bold, italic, or fixed font * Tables * Separators 1. After your article is migrated to the wiki, the original Jazz.net article requires a banner that states: <br><br> *The content of this article has been migrated to the [[https://jazz.net/wiki/bin/view/Deployment/VersionCompatibilityCLMRRDIAndInsight][Deployment wiki: Version Compatibility Matrix for RRDI, CLM, and Rational Insight]] topic page. The content will be maintained and updated in the wiki going forward. Therefore, this version of the article might not contain the most up to date information. All deployment guidance and best practice will be published in the [[https://jazz.net/wiki/bin/view/Deployment/WebHome][Deployment wiki]] rather than as Jazz.net articles going forward.* <br><br> The first hyperlink will be to the new topic page where the content of the jazz.net article has been migrated to. Please raise a new task within the [[https://jazz.net/jazz02/web/projects/JazzCS#action=com.ibm.team.workitem.newWorkItem&type=task&ts=1380069013000][JazzCS]] RTC project to request a banner to be added to the migrated Jazz.net article: * Set the 'Owned By' field to 'Reuben Varzea' * Set the 'Summary' field to 'Add migration banner to Jazz.net article:' with the article's name * Include in the 'Description' field the hyperlink to the new wiki topic page where the content of the article has been migrated to e.g. [[https://jazz.net/wiki/bin/view/Deployment/VersionCompatibilityCLMRRDIAndInsight][Deployment wiki: Version Compatibility Matrix for RRDI, CLM, and Rational Insight]] ---+++ Formatting notes * The heading styles are different in Jazz.net and on the wiki. Use the wiki style rather than trying to retrofit the Jazz.net style. * The wiki converts any words that look like a !WikiWord to a link to a potential wiki page. Common examples are WikiWord, WebSphere, SmartCloud, and DevOps. You can disable this behavior in two ways: * To disable individual instances, prefix the unintended !WikiWord with an exclamation point (example: =!WebSphere=). * To disable all automatic linking of WikiWords, surround any portion of the page text with <noautolink> and </noautolink> tags. * To exclude a heading from the TOC, put !! after the heading notation (---+!!). * The wiki link notation opens the linked page in the same window as the current page. To open a link on a new tab or page, use a standard anchor tag with the target="_blank" attribute: <a href="http://www.ibm.com/" target="_blank">link text</a>. #MigratingGraphics ---+++ Migrating graphics 1. Right-click the graphic. 1. Save the graphic on your hard drive. 1. In the upper-right corner of your new wiki page, click *Attach*. (This link is not available when the page is in edit mode.) 1. Select the file that you saved on your hard drive. 1. In the Properties section, select *Create a link to the attached file*. A new =img= link is created at the bottom of the wiki page. 1. Open the wiki page for editing. Copy the new =img= link from the bottom of the page to the clipboard. Paste the link where you want the graphic to be displayed. Delete the link and its accompanying code from the bottom of the page. 1. To align the new =img= centrally and have an associated caption, use the following format: <VERBATIM> <div style="text-align:center;"><img src="%ATTACHURLPATH%/image.png" alt="image.png" width="70%"/><br><br> __Caption__ </div> </VERBATIM> ---+++++!! Related topics: [[DeploymentFormattingGuidance][Deployment formatting guidance]], [[DeploymentWritingGuidelines][Writing guidelines]] ---+++++!! External links: None ---+++++!! Additional contributors: None <sticky></div></sticky>
Edit
|
Attach
|
P
rintable
|
V
iew topic
|
Backlinks:
We
b
,
A
l
l Webs
|
H
istory
:
r25
|
r21
<
r20
<
r19
<
r18
|
More topic actions...
Deployment
Deployment web
Planning and design
Installing and upgrading
Migrating and evolving
Integrating
Administering
Monitoring
Troubleshooting
Community information and contribution guidelines
Create new topic
Topic list
Search
Advanced search
Notify
RSS
Atom
Changes
Statistics
Web preferences
NOTE: Please use the Sandbox web for testing
Status icon key:
To do
Under construction
New
Updated
Constant change
None - stable page
Smaller versions of status icons for inline text:
Copyright © by IBM and non-IBM contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our
Terms of Use.
Please read the following
disclaimer
.
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more
here
.