about summary refs log tree commit diff
path: root/.venv/lib/python3.12/site-packages/olefile/doc/OLE_Overview.md
diff options
context:
space:
mode:
Diffstat (limited to '.venv/lib/python3.12/site-packages/olefile/doc/OLE_Overview.md')
-rw-r--r--.venv/lib/python3.12/site-packages/olefile/doc/OLE_Overview.md29
1 files changed, 29 insertions, 0 deletions
diff --git a/.venv/lib/python3.12/site-packages/olefile/doc/OLE_Overview.md b/.venv/lib/python3.12/site-packages/olefile/doc/OLE_Overview.md
new file mode 100644
index 00000000..db7fa668
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/olefile/doc/OLE_Overview.md
@@ -0,0 +1,29 @@
+About the structure of OLE files

+================================

+

+This page is part of the documentation for [olefile](https://bitbucket.org/decalage/olefileio_pl/wiki). It provides a brief overview of the structure of [Microsoft OLE2 files (also called Structured Storage, Compound File Binary Format or Compound Document File Format)](http://en.wikipedia.org/wiki/Compound_File_Binary_Format), such as Microsoft Office 97-2003 documents, Image Composer and FlashPix files, Outlook messages, StickyNotes, several Microscopy file formats, McAfee antivirus quarantine files, etc.

+  

+An OLE file can be seen as a mini file system or a Zip archive: It contains **streams** of data that look like files embedded within the OLE file. Each stream has a name. For example, the main stream of a MS Word document containing its text is named "WordDocument".

+

+An OLE file can also contain **storages**. A storage is a folder that contains streams or other storages. For example, a MS Word document with VBA macros has a storage called "Macros".

+

+Special streams can contain **properties**. A property is a specific value that can be used to store information such as the metadata of a document (title, author, creation date, etc). Property stream names usually start with the character '\x05'.

+

+For example, a typical MS Word document may look like this:

+

+![](OLE_VBA_sample.png)

+

+Go to the [[API]] page to see how to use all olefile features to parse OLE files.

+

+

+--------------------------------------------------------------------------

+

+olefile documentation

+---------------------

+

+- [[Home]]

+- [[License]]

+- [[Install]]

+- [[Contribute]], Suggest Improvements or Report Issues

+- [[OLE_Overview]]

+- [[API]] and Usage