2013-01-17 3 views
3

DITA를 사용하여 사용자 문서를 생성하고 PDF 및 XHTML 산출물을 생성하고 있습니다. YouTube 동영상을 삽입 할 때 사용할 수있는 DITA 요소는 무엇입니까?YouTube 동영상을 삽입하는 데 사용할 수있는 DITA 요소는 무엇입니까?

이상적으로 저는 스타일 시트를 사용하여 소스 코드를 생성하고 문서에 비디오 링크를 추가하는 것을 선호합니다. 내가 이것을 달성하기 위해 표준 DITA 요소 중 하나를 사용하는 것을 선호

<fig audience="web"> 
    <title>YouTube 101: How to Find What's Hot on YouTube</title> 
    <video href="http://www.youtube.com/watch?feature=player_embedded&v=FEyRza0rJyI"> 
     <alt>This video explains how to tap into the cultural zeitgeist happening on YouTube right now.</alt> 
    </video> 
</fig> 

가능하다면 : 여기에 내가 그런 요소가 의사 마크 업을 사용 보일 수 있습니다 직시하는 방법입니다.

답변

2

이것이 올바른 방법인지 확실하지 않지만 작동하는 것처럼 보이며 작업하기가 쉽습니다. 추가 정보를 읽은 후 <object> 요소는 비디오, 미디어 및 ActiveX 컨트롤을 포함하도록 설계되었습니다.

초기 검사에서 YouTube 동영상을 삽입하는 과정은 다소 복잡해 보입니다. 여러 블로그/포럼에서 (구식) YouTube 퍼가기 코드를 복사하고 DITA와 호환되지 않는 부분을 제거하는 방법에 대해 설명합니다. 불행히도이 기술은 일부 상황에서 재생 문제를 일으키는 것으로보고되었습니다.

  • http://code.google.com/p/jallib/issues/detail?id=109
  • http://flowwrite.blogspot.co.uk/2008/08/how-to-embed-youtube-video-into-dita.html
    • 그래서 대신 내가 <object> 요소를 사용하여 그러나이 모든 과정을 쉽게 사용자 정의 스타일을 실험하기로 결정했다. 이 방법이 기술적으로 유효한지 확실치 않은데, 그 점에 대해서는 의견을 보내 주시면 감사하겠습니다.

      • @type - 사용자 정의 XSL 렌더링을 트리거 "유튜브"의 값을 지정합니다.
      • @ 데이터 - YouTube 동영상 ID는 소스 코드에서 복사 할 수 있습니다.
      • @ (선택 사항) - 브라우저에서 YouTube 동영상의 너비는 기본값이 600px입니다.
      • @height (선택 사항) - 브라우저에서 YouTube 동영상의 높이, 기본값은 450px입니다. 여기

      이 기술을 이용하여 동영상 삽입의 예이다 :는 XHTML 출력을 생성하는 방법을 변경할 필요가 이러한 작업을하기 위해

      <!-- DITA markup --> 
      <fig audience="web"> 
          <title>YouTube 101: How to Find What's Hot on YouTube</title> 
          <object type="youtube" data="FEyRza0rJyI"> 
           <desc>This video explains how to tap into the cultural zeitgeist happening on YouTube right now.</desc> 
          </object> 
      </fig> 
      

      . 다행히도 이것은 DITA Converter (일명 Ditac) XML Mind으로 매우 쉽습니다. 난 그저 내 XSL 사용자 정의 스타일 시트에 다음과 같은 추가 : 내 경우

      <!-- Customize html output (works with DITA Converted by XML Mind) --> 
      <xsl:template match="*[contains(@class,' topic/object ') and @type='youtube']"> 
          <iframe src="http://www.youtube-nocookie.com/embed/{@data}?rel=0" frameborder="0" allowfullscreen="allowfullscreen"> 
           <xsl:attribute name="width" select="if (@width) then @width else '600'"/> 
           <xsl:attribute name="height" select="if (@height) then @height else '450'"/> 
           <xsl:call-template name="commonAttributes"/> 
           <xsl:call-template name="namedAnchor"/> 
          </iframe> 
      </xsl:template> 
      

      나는 웹 기반 콘텐츠에 대한 비디오를 삽입에만 관심을, 그리고 @audience 속성을 추가 이러한 이유로 충분하다. 그러나 URL과 설명 텍스트가있는 인쇄물에 대한 대체 출력을 만드는 것은 쉽습니다.

    6

    제안 된 오버 라이드는 완벽합니다. Lea. 표시 한 속성 매핑은 전달하는 데이터의 종류에 적합합니다.현재의 YouTube 인터페이스와의 긴밀한 매칭을 전문으로하여 오버 엔지니어링 할 수 있지만, 다시 변경 될 가능성이 있으므로 접근법에 대한 간단한 문서화가 괜찮은 경우입니다. 실제로 XML Mind 편집기에서 pseudo-element (예 : Insert special character using :before pseudo class in css 참조)를 사용하여 사용자에게 어떤 데이터를 어디에 넣을지 알려줄 수 있습니다 (양식의 필드 레이블과 같이 작동합니다). Ditac에서이 사용법을 재정의 한 예는 누군가가 DITA OT 변환을 적용 할 수있는 방법을 자세히 모델링합니다.

    DITA 출판사위한 프로젝트 ( http://dita4publishers.sourceforge.net)
    5

    는 DITA 전문의 제약 내에서 최대한 가깝게 HTML5 <video> 소자 평행하도록 전문 영역을 제공한다. 마크 업은 다음과 같습니다.

    <fig 
        outputclass="image"> 
        <d4p_video 
        id="E5123_026.mp4" 
        width="300" 
        height="300"> 
        <d4p_video_poster 
         value="../images/E5123_026_poster.png"/> 
        <d4p_video_source 
         value="../images/E5123_026.mp4" 
         type="video/mp4"/> 
        </d4p_video> 
    </fig> 
    

    마크 업은 d4p_mediaDomain에 정의되어 있습니다. DITA for Publishers 프로젝트에는 HTML 기반 출력 (HTML, EPUB 등)에 대한이 마크 업에서 HTML5 비디오 마크 업을 생성하는 기능이 포함되어 있습니다.

    2

    는 다음과 같은 마크 업 DITA-OT에서 제대로 작동 1.5.4와 1.7.2 (의 사이에 아마도 모든) : 분명히

    <object width="640" height="360" data="//www.youtube.com/embed/vwh93zo7_oU?rel=0"> 
        <param name="src" value="//www.youtube.com/embed/vwh93zo7_oU?rel=0"/> 
        <param name="movie" value="//www.youtube.com/embed/vwh93zo7_oU?rel=0"/> 
        <param name="allowFullScreen" value="true"/> 
        <param name="allowscriptaccess" value="always"/> 
    </object> 
    

    , 세 곳에서 비디오의 ID를 대체 - 내가 사용하는 비디오는 우리 문서의 일부이므로 실습 예제가 있어야합니다.

    • @height 속성은 비디오가 표시되는 상자의 크기를 정의합니다.
    • @data 속성과 처음 두 개의 <param> 요소는 동영상에 대한 링크를 지정합니다. 브라우저 간 호환성을 위해 세 가지 모두를 포함하십시오.
    • 마지막 두 개의 <param> 요소는 비디오에 허용 할 선택적 동작을 지정합니다. 필요하지 않을 수도 있습니다.

    필요한 마크 업을 줄이는 전문화를 만들 수는 있지만이 경우에는 노력을 정당화 할만한 충분한 비디오가 포함되어 있지 않습니다.

    0

    리아 - 한 메모 만 있으면 플래시 콘텐츠를 PDF에 삽입 할 수 있습니다 (예 : 동영상 링크가있는 플래시로 작성된 YouTube 동영상 플레이어). 나는 후보자를 찾지 않았지만 그들이 존재한다고 확신한다. 사용하는 PDF 렌더링 엔진에서 RichMedia 주석을 PDF에 포함 할 수 있으면 대화식 Flash를 PDF에 바로 배치 할 수 있습니다.