Difference between revisions of "ApiFusion.org/Modules/Import"

From ApiFusion
Jump to: navigation, search
Line 1: Line 1:
Invoked from sidebar Tools/Import.
 
 
= Import between mediawiki =
 
[[ApiFusion.org/Sources/ui/tools/ImportWiki.html|ImportWiki.html]] gives ability to import content of one MediaWiki into another in browser. You could choose the import of whole content, pages, or namespaces.
 
 
 
= GIT Repositories =
 
= GIT Repositories =
[[ApiFusion.org/Sources/ui/tools/ImportGit.html|ImportGit.html]] External git repositories could be the source and backup location for module and any branch within its hierarchy.
+
[[ApiFusion.org/Sources/ui/tools/ImportGit.html|ImportGit.html]] is a tool to sync external git repository folder to AF subfolder.
  
Different repositories could be associated with same or different paths, each holding particular type of information. For example, API documentation could reside separately from sources; contributors info structure will not match the source hierarchy leaving only top levels where particular contributor was involved.
+
Same AF subtree could reflect the hierarchy of different repositories, each holding particular type of information. For example, API documentation could reside in separate repo from sources of embedded into sources themselves; contributors info structure will not match the source hierarchy leaving only top levels where particular contributor was involved.
  
 
== Import ==
 
== Import ==
For import from git repository you would need a [[ApiFusion.org/Sources/git-restful|git-restful]] server access.
+
For import from git repository you would need a [[ApiFusion.org/Sources/git-restful|git-restful]] server instance access.
Repository Import/Sync opens the wizard of folders/files along with recognized features. Wizard shall guide over features and help to select the relevant and updated(since last sync) ones. Once sync content selected, it will be posted under AF project/module tree.
+
 
 +
[[ApiFusion.org/Sources/ui/tools/ImportGit.html|ImportGit.html]] is the wizard of folders/files along with recognized features. Wizard guides over features and help to select the relevant and updated(since last sync) ones. Once sync content selected, it will be posted under AF project/module tree.
  
 
It shall be available on any project level with ability to override the path within version control.
 
It shall be available on any project level with ability to override the path within version control.
Line 24: Line 20:
 
== Repo sync ==
 
== Repo sync ==
 
Two-way synchronization with exposed diffs and author/dates TBD.
 
Two-way synchronization with exposed diffs and author/dates TBD.
 
= Project level =
 
Has multiple modules listed. Import action should trigger the previously configured imports on each.
 
 
= Import configuration =
 
The import configuration for module is set during the first import action and comprise
 
* the repository path
 
* path of (sub-)module
 
* namespaces selection where imported data preserved
 
By default all namespaces will try to get relevant information from data at repository path.
 
 
{{Requirements:ApiFusion.org/Modules/Import}}
 

Revision as of 04:09, 10 July 2017

GIT Repositories

ImportGit.html is a tool to sync external git repository folder to AF subfolder.

Same AF subtree could reflect the hierarchy of different repositories, each holding particular type of information. For example, API documentation could reside in separate repo from sources of embedded into sources themselves; contributors info structure will not match the source hierarchy leaving only top levels where particular contributor was involved.

Import

For import from git repository you would need a git-restful server instance access.

ImportGit.html is the wizard of folders/files along with recognized features. Wizard guides over features and help to select the relevant and updated(since last sync) ones. Once sync content selected, it will be posted under AF project/module tree.

It shall be available on any project level with ability to override the path within version control.

Export

Back commit of AF data TBD.


UI access

The command will be available for every page over Tools menu in Sidebar

Repo sync

Two-way synchronization with exposed diffs and author/dates TBD.