Python/python-pptx 사용자 가이드 - 13. Notes

https://python-pptx.readthedocs.io/en/latest/user/notes.html

Working with Notes Slides

A slide can have notes associated with it. These are perhaps most commonly encountered in the notes pane, below the slide in PowerPoint “Normal” view where it may say “Click to add notes”.

The notes added here appear each time that slide is present in the main pane. They also appear in Presenter View and in Notes Page view, both available from the menu.

Notes can contain rich text, commonly bullets, bold, varying font sizes and colors, etc. The Notes Page view has somewhat more powerful tools for editing the notes text than the note pane in Normal view.

In the API and the underlying XML, the object that contains the text is known as a Notes Slide. This is because internally, a notes slide is actually a specialized instance of a slide. It contains shapes, many of which are placeholders, and allows inserting of new shapes such as pictures (a logo perhaps) auto shapes, tables, and charts. Consequently, working with a notes slide is very much like working with a regular slide.

Each slide can have zero or one notes slide. A notes slide is created the first time it is used, generally perhaps by adding notes text to a slide. Once created, it stays, even if all the text is deleted.

슬라이드에는 슬라이드와 관련된 메모가 있을 수 있다. 이것은 PowerPoint "일반" 보기의 슬라이드 아래에 있는 “Click to add notes”라고 표시된 노트 창에서 가장 흔히 볼 수 있다.

여기에 추가된 메모는 해당 슬라이드가 기본 창에 나타날 때마다 나타난다. 발표자 보기와 노트 페이지 보기에도 표시되며 둘 다 메뉴에서 사용할 수 있다.

노트에는 서식 있는 텍스트, 일반적으로 글머리 기호, 굵게, 다양한 글꼴 크기 및 색상 등이 포함될 수 있다. 노트 페이지 보기에는 기본 보기의 노트 창보다 노트 텍스트를 편집하기 위한 좀 더 강력한 도구가 있다.

API와 기본 XML에서는 텍스트가 포함된 개체를 노트 슬라이드라고 한다. 이는 내부적으로 Notes 슬라이드가 실제로 슬라이드의 특수한 인스턴스이기 때문이다. 여기에는 도형이 포함되어 있으며 그 중 대부분은 자리 표시자이며 그림(로고일 수 있음) 자동 도형, 표 및 차트와 같은 새로운 도형을 삽입할 수 있다. 결과적으로, 노트 슬라이드 작업은 일반 슬라이드 작업과 매우 유사하다.

각 슬라이드에는 메모 슬라이드가 0개 또는 1개 있을 수 있다. 메모 슬라이드는 처음 사용할 때 일반적으로 슬라이드에 메모 텍스트를 추가하여 만들어진다. 한번 생성되면 모든 텍스트가 삭제되더라도 그대로 유지된다.

The Notes Master

A new notes slide is created using the Notes Master as a template. A presentation has no notes master when newly created in PowerPoint. One is created according to a PowerPoint-internal preset default the first time it is needed, which is generally when the first notes slide is created. It’s possible one can also be created by entering the Notes Master view and almost certainly is created by editing the master found there (haven’t tried it though). A presentation can have at most one notes master.

The notes master governs the look and feel of notes pages, which can be viewed on-screen but are really designed for printing out. So if you want your notes page print-outs to look different from the default, you can make a lot of customizations by editing the notes master. You access the notes master editor using View > Master > Notes Master on the menu (on my version at least). Notes slides created using python-pptx will have the look and feel of the notes master in the presentation file you opened to create the presentation.

On creation, certain placeholders (slide image, notes, slide number) are copied from the notes master onto the new notes slide (if they have not been removed from the master). These “cloned” placeholders inherit position, size, and formatting from their corresponding notes master placeholder. If the position, size, or formatting of a notes slide placeholder is changed, the changed property is no long inherited (unchanged properties, however, continue to be inherited).

Notes 마스터를 템플릿으로 사용하여 새 메모 슬라이드가 생성된다. PowerPoint에서 새로 만든 프레젠테이션에는 노트 마스터가 없다. 하나는 처음 필요할 때 PowerPoint 내부 사전 설정 기본값에 따라 생성되며 일반적으로 첫 번째 노트 슬라이드가 생성될 때이다. Notes 마스터 보기에 들어가서 생성할 수도 있으며 거기에 있는 마스터를 편집하여 생성되는 것이 거의 확실하다(시도하지는 않았다). 프레젠테이션에는 최대 하나의 메모 마스터가 있을 수 있다.

Notes 마스터는 화면에서 볼 수 있지만 실제로는 인쇄용으로 디자인된 Notes 페이지의 보기와 느낌을 관리한다. 따라서 노트 페이지 인쇄물이 기본값과 다르게 보이도록 하려면 노트 마스터를 편집하여 다양한 사용자 정의를 수행할 수 있다. 메뉴에서 보기 > 마스터 > 노트 마스터를 사용하여 노트 마스터 편집기에 액세스한다. python-pptx를 사용하여 만든 Notes 슬라이드는 프레젠테이션을 만들기 위해 연 프레젠테이션 파일에 있는 Notes 마스터의 보기와 느낌을 갖는다.

생성 시 특정 자리 표시자(슬라이드 이미지, 메모, 슬라이드 번호)가 메모 마스터에서 새 메모 슬라이드로 복사된다(마스터에서 제거되지 않은 경우). 이러한 "복제된" 자리 표시자는 해당 메모 마스터 자리 표시자로부터 위치, 크기 및 서식을 상속받는다. 메모 슬라이드 자리 표시자의 위치, 크기 또는 서식이 변경되면 변경된 속성은 더 이상 상속되지 않는다. 그러나 변경되지 않은 속성은 계속 상속된다.

Notes Slide basics

Enough talk, let’s show some code. Let’s say you have a slide you’re working with and you want to see if it has a notes slide yet:

작업 중인 슬라이드가 있고 아직 노트 슬라이드가 있는지 확인하고 싶다고 가정해 본다.

>>> slide.has_notes_slide
False

Ok, not yet. Good. Let’s add some notes:

몇 가지 참고 사항을 추가해 본다.

>>> notes_slide = slide.notes_slide
>>> text_frame = notes_slide.notes_text_frame
>>> text_frame.text = 'foobar'

Alright, simple enough. Let’s look at what happened here:

• slide.notes_slide gave us the notes slide. In this case, it first created that notes slide based on the notes master. If there was no notes master, it created that too. So a lot of things can happen behind the scenes with this call the first time you call it, but if we called it again it would just give us back the reference to the same notes slide, which it caches, once retrieved.
• notes_slide.notes_text_frame gave us the TextFrame object that contains the actual notes. The reason it’s not just notes_slide.text_frame is that there are potentially more than one. What this is doing behind the scenes is finding the placeholder shape that contains the notes (as opposed to the slide image, header, slide number, etc.) and giving us that particular text frame.
• A text frame in a notes slide works the same as one in a regular slide. More precisely, a text frame on a shape in a notes slide works the same as in any other shape. We used the .text property to quickly pop some text in there.

여기서 무슨 일이 일어났는지 살펴본다.

• Slide.notes_slide는 우리에게 노트 슬라이드를 제공했다. 이 경우 먼저 노트 마스터를 기반으로 해당 노트 슬라이드를 만들었다. Notes 마스터가 없으면 그것도 생성된다. 따라서 이 호출을 처음 호출할 때 뒤에서 많은 일이 발생할 수 있지만 다시 호출하면 검색된 후 캐시된 동일한 메모 슬라이드에 대한 참조를 다시 제공할 뿐이다.
• Notes_slide.notes_text_frame은 실제 메모가 포함된 TextFrame 객체를 제공했다. 단지 Notes_slide.text_frame이 아닌 이유는 잠재적으로 둘 이상이 있을 수 있기 때문이다. 이 작업이 뒤에서 수행하는 작업은 노트(슬라이드 이미지, 헤더, 슬라이드 번호 등이 아님)가 포함된 자리 표시자 도형을 찾아 해당 특정 텍스트 프레임을 제공하는 것이다.
• 노트 슬라이드의 텍스트 프레임은 일반 슬라이드의 텍스트 프레임과 동일하게 작동한다. 보다 정확하게는 노트 슬라이드의 도형에 있는 텍스트 프레임은 다른 도형과 동일하게 작동한다. 우리는 .text 속성을 사용하여 거기에 일부 텍스트를 빠르게 표시했다.

Using the text frame, you can add an arbitrary amount of text, formatted however you want.

텍스트 프레임을 사용하면 원하는 형식으로 임의의 양의 텍스트를 추가할 수 있다.

Notes Slide Placeholders

What we haven’t explicitly seen so far is the shapes on a slide master. It’s easy to get started with that:

지금까지 우리가 명시적으로 보지 못한 것은 슬라이드 마스터의 도형이다. 시작하는 것은 쉽다:

>>> notes_placeholder = notes_slide.notes_placeholder

This notes placeholder is just like a body placeholder we saw a couple sections back. You can change its position, size, and many other attributes, as well as get at its text via its text frame.

You can also access the other placeholders:

이 메모 자리 표시자는 앞에서 몇 섹션에서 본 본문 자리 표시자와 같다. 위치, 크기 및 기타 여러 속성을 변경할 수 있을 뿐만 아니라 텍스트 프레임을 통해 텍스트를 가져올 수도 있다.

다른 자리 표시자에도 액세스할 수 있다.

>>> for placeholder in notes_slide.placeholders:
...   print placeholder.placeholder_format.type
...
SLIDE_IMAGE (101)
BODY (2)
SLIDE_NUMBER (13)

and also the shapes (a superset of the placeholders):

도형(자리 표시자의 상위 집합):

>>> for shape in notes_slide.shapes:
...   print shape
...

In the common case, the notes slide contains only placeholders. However, if you added an image, for example, to the notes slide, that would show up as well. Note that if you added that image to the notes master, perhaps a logo, it would appear on the notes slide “visually”, but would not appear as a shape in the notes slide shape collection. Rather, it is visually “inherited” from the notes master.

일반적인 경우 메모 슬라이드에는 자리 표시자만 포함된다. 그러나 예를 들어 노트 슬라이드에 이미지를 추가하면 해당 이미지도 표시된다. 해당 이미지(예: 로고)를 노트 마스터에 추가한 경우 노트 슬라이드에 "시각적으로" 표시되지만 노트 슬라이드 도형 컬렉션에는 도형으로 표시되지 않는다. 오히려 Notes 마스터에서 시각적으로 "상속"된다.

 

Python/python-pptx 사용자 가이드