How to use converted output? #1

New Issue

alansill · 2022-09-09T00:37:10+02:00

alansill commented

2022-09-09 00:37:10 +02:00

I can run the conversion tool on my dokuwiki site, but can't figure otu the steps needed to use the converted output in hugo. What am I missing?

wgroeneveld commented

2022-09-09 14:25:10 +02:00

Hi, if you managed to point the tool to the folder of your dokuwiki files that need to be converted, it should have created an output/ folder where all converted files are placed.

See https://git.brainbaking.com/wgroeneveld/dokuwiki-to-hugo/src/branch/master/src/dokuwiki_to_hugo.py

The output is just Markdown, which Hugo is of course compatible with. That means you can throw it in your Hugo site's content/ directory and presto!

Good luck,
Wouter

Hi, if you managed to point the tool to the folder of your dokuwiki files that need to be converted, it should have created an `output/` folder where all converted files are placed. See https://git.brainbaking.com/wgroeneveld/dokuwiki-to-hugo/src/branch/master/src/dokuwiki_to_hugo.py The output is just Markdown, which Hugo is of course compatible with. That means you can throw it in your Hugo site's `content/` directory and presto! Good luck, Wouter

wgroeneveld closed this issue

2022-09-09 14:25:10 +02:00

alansill commented

2022-09-11 04:23:55 +02:00

Hmm, thanks. I did exactly that, but nothing shows up when I launch a hugo server, just a blank page at the initial launch and I canʻt determine the pattern of URLs that should work with the converted files. Looking at the converted pages, I see that hugo detects a lot of such files (over 8000 in my case as I was converting an extensive site), and seems to detect a sitemap, but I canʻt guess what URL to navigate to in order to find it.

Is there a sanity check or other direct test I can do on the converted output?

Hmm, thanks. I did exactly that, but nothing shows up when I launch a hugo server, just a blank page at the initial launch and I canʻt determine the pattern of URLs that should work with the converted files. Looking at the converted pages, I see that hugo detects a lot of such files (over 8000 in my case as I was converting an extensive site), and seems to detect a sitemap, but I canʻt guess what URL to navigate to in order to find it. Is there a sanity check or other direct test I can do on the converted output?

alansill commented

2022-09-11 04:26:33 +02:00

As a definite improvement, can I suggest including a small test set of original and converted files for an example dokuwiki site, or source files and a set of instrucitons on how to run a test conversion to ensure the tool is working right after installation?

wgroeneveld commented

2022-09-12 10:04:36 +02:00

As a definite improvement, can I suggest including a small test set of original and converted files for an example dokuwiki site, or source files and a set of instrucitons on how to run a test conversion to ensure the tool is working right after installation?

That's already present as a set of python unit tests, see the test/ dir.

If the files are there, then this tool is done and you should look into what causes Hugo to ignore them. Perhaps it's the theme, since that also determines which folder too look in.

> As a definite improvement, can I suggest including a small test set of original and converted files for an example dokuwiki site, or source files and a set of instrucitons on how to run a test conversion to ensure the tool is working right after installation? That's already present as a set of python unit tests, see the `test/` dir. If the files are there, then this tool is done and you should look into what causes Hugo to ignore them. Perhaps it's the theme, since that also determines which folder too look in.

Sign in to join this conversation.

No Label

No Milestone

No project

No Assignees

2 Participants

Notifications

Due Date

The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: wgroeneveld/dokuwiki-to-hugo#1