Line 10: |
Line 10: |
| * package Journal objects to bundles to preserve sugar related metadata | | * package Journal objects to bundles to preserve sugar related metadata |
| * support composite Journal objects e.g. in case of library bundles instead of having .xol in Journal and unpacked files in ~/Library, all library files will be represented by one Journal entry, could be opened in Browse(''[Metadata]/mime_type'' should be text/html for that purpose) and could be transformed back to .xo on demand(e.g. for uploading library in Browse's pick-file field). | | * support composite Journal objects e.g. in case of library bundles instead of having .xol in Journal and unpacked files in ~/Library, all library files will be represented by one Journal entry, could be opened in Browse(''[Metadata]/mime_type'' should be text/html for that purpose) and could be transformed back to .xo on demand(e.g. for uploading library in Browse's pick-file field). |
| + | * Object Bundles exist only out of sugar (after uploading to the Journal .xo will be removed) |
| | | |
| == Owner == | | == Owner == |
Line 18: |
Line 19: |
| == Current status == | | == Current status == |
| | | |
− | * Targeted release: 0.86 | + | * Targeted release: |
| * Last updated: Mon Jul 27 05:31:42 UTC 2009 | | * Last updated: Mon Jul 27 05:31:42 UTC 2009 |
| * Percentage of completion: 75% | | * Percentage of completion: 75% |
Line 32: |
Line 33: |
| This file is in [http://docs.python.org/library/configparser.html INI] format which describes how to setup bundle. | | This file is in [http://docs.python.org/library/configparser.html INI] format which describes how to setup bundle. |
| | | |
− | Object bundle can be installed to Journal in two forms: | + | Object bundle can be installed to Journal in two forms. |
− | * files from bundle will be unpacked and installed as separate Journal entries, bundle itself will be removed(similar to .xoj)<br>final Journal entries can have ''activity'' field, so they are regular Journal entries that imported to Journal(w/o ''activity'' field) or created by activities(with ''activity'' field)<br>''METADATA'' should contain ''[Entry]'' sections for each Journal entry<br>if bundle has more then one entry, sections should be parted by different suffixes e.g. ''[Entry2]'', ''[Entry.additional]'' etc. | + | |
− | * bundle will be installed as a composite object i.e. as a directory of packaged to the bundle files that are represented by one Journal entry<br>final Journal entry can't have ''activity'' field<br>''METADATA'' should contain only one ''[Bundle]'' section | + | * '''Each file from bundle as separate Journal entry'''<br>files from bundle will be unpacked and installed as separate Journal entries, bundle itself will be removed(similar to .xoj)<br>final Journal entries can have ''activity'' field, so they are regular Journal entries that imported to Journal(w/o ''activity'' field) or created by activities(with ''activity'' field)<br>''METADATA'' should contain ''[Entry]'' sections for each Journal entry<br>if bundle has more then one entry, sections should be parted by different suffixes e.g. ''[Entry2]'', ''[Entry.additional]'' etc. |
| + | |
| + | * '''Composite Journal entry'''<br>bundle will be installed as a composite object i.e. as a directory of packaged to the bundle files that are represented by one Journal entry<br>final Journal entry can't have ''activity'' field<br>''METADATA'' should contain only one ''[Bundle]'' section |
| | | |
| METADATA file can have one or several sections(depends on installation method) that describe metadata fields of final entry(ies) in Journal. | | METADATA file can have one or several sections(depends on installation method) that describe metadata fields of final entry(ies) in Journal. |
Line 155: |
Line 158: |
| } | | } |
| | | |
− | echo $tmpdir."\n";
| |
| rmtree($tmpdir); | | rmtree($tmpdir); |
| return $result; | | return $result; |
| } | | } |
| + | |
| + | // example usage of unbundle() function |
| | | |
| $bundle = 'foo.xo'; | | $bundle = 'foo.xo'; |
Line 197: |
Line 201: |
| == Documentation == | | == Documentation == |
| | | |
| + | * [http://www.mail-archive.com/sugar-devel@lists.sugarlabs.org/msg06874.html Email thread] |
| * [[Unified Bundles]] | | * [[Unified Bundles]] |
− | * [[Unified Objects]] | + | * [[User:Alsroot/trash/Unified Objects | Unified Objects]] |
| * [http://wiki.laptop.org/go/Journal_entry_bundles Journal entry bundles] | | * [http://wiki.laptop.org/go/Journal_entry_bundles Journal entry bundles] |
| * [http://wiki.laptop.org/go/Bundle_concepts Bundle concepts] | | * [http://wiki.laptop.org/go/Bundle_concepts Bundle concepts] |
Line 208: |
Line 213: |
| == Comments and Discussion == | | == Comments and Discussion == |
| * See [[{{TALKPAGENAME}}|discussion tab for this feature]] <!-- This adds a link to the "discussion" tab associated with your page. This provides the ability to have ongoing comments or conversation without bogging down the main feature page --> | | * See [[{{TALKPAGENAME}}|discussion tab for this feature]] <!-- This adds a link to the "discussion" tab associated with your page. This provides the ability to have ongoing comments or conversation without bogging down the main feature page --> |
− |
| |
− |
| |
− | [[Category:Feature Page Incomplete]]
| |
− | [[Category:Feature]]
| |