Docsify does not preserve alias when importing an image #1870

Activity

1. Koooooo-7

   added

   needs investigation

   on Aug 26, 2022
2. hamishwillee commented on Aug 31, 2022

   

   hamishwillee

   on Aug 31, 2022

   Author

   More actions

   Note, you can work around this with a hook, a bit like:

                 let my_dir_path = vm.route.file.split('/');
                 my_dir_path.pop();
                 let fixcontent = content.replace(/\!\[(.*?)\]\((.*?)\)/g, 
                   (match, title, path) => {
                     let linkrootpath=my_dir_path.slice();
                     let relpath = path;
                     if (relpath.startsWith('../')) {
   
                       while (relpath.startsWith('../')) {
                         relpath = relpath.slice(3);
                         linkrootpath.pop();
                       }
   
                     linkrootpath = linkrootpath.join('/');
                     linkrootpath = `${linkrootpath}/${relpath}`;
                     let imagestring = `<img src="${linkrootpath}" title="${title}" />`;
                     return imagestring;
                     }
                     else {
                       return match;
                     }
   
                   }
                 );

   But I think it is reasonable for a user to assume that docsify will do this for relative links on the remote content. And of course someone who is better at javascript could write a better method.
3. Koooooo-7

   added

   enhancement

   and removed

   needs investigation

   on Sep 3, 2022
4. fluxion-dev commented on Feb 14, 2023

   

   fluxion-dev

   on Feb 14, 2023

   More actions

   @hamishwillee We're currently trying to integrate remote documentation and preserve aliasing in our project. This would be a great feature to have.
5. hamishwillee commented on Feb 14, 2023

   

   hamishwillee

   on Feb 14, 2023

   Last edited by hamishwillee

   Author

   More actions

   @impr0t Yes it would. This project is odd - truly innovative, and yet a few core things don't work, and never get fixed. The other one is relative/absolute paths - which break for the sidebar.

   PS, I haven't finished, but if you're interested in seeing some of the things I've tried there is a branch here: https://github.com/hamishwillee/multidocsify_test/tree/px4test_docsify that renders to this https://hamishwillee.github.io/multidocsify_test/#/main/en/

   Same requirement - multiple remote sources accessed via aliasing - with translation and versioning.

   This uses https://evilmartians.com/chronicles/easy-multi-language-multi-version-documentation-with-docsify-git-and-github-actions to handle dynamically updating the sidebar links and hooks for the images.

   Note that the only changes I needed to make for this to work with my old gitbook build was to make the SUMMARY.md links to start with /