loading...

re: How To Document A Kotlin Project VIEW POST

TOP OF THREAD FULL DISCUSSION
re: Hi Mahdi, thanks for trying Orchid out! There are a few things you could check: Are the sourceDirs paths set up correctly? On the command-line, i...
 

I'm using version 0.16.10 on a Windows machine running Android Studio 3.4
This is my directory tree

and this is my config.yml

theme:
  menu:
    - type: 'kotlindocPackages'
    - type: 'kotlindocClasses'
  kotlindoc:
    sourceDirs:
      - "./../../../../module1/src/main/java"
    pages:
      extraCss:
        - 'assets/css/orchidKotlindoc.scss'
      menu:
        - type: "kotlindocClassLinks"
          includeItems: true

All of the other parts like wiki and pages are working but dokka is not generating any docs
there isn't any error and ALL PACKAGES or ALL CLASSES are linked to localhost:8080

i've tried these sourceDirs to see if i'm not pointing to an empty dir or maybe this is not how we get to a directory on Windows
"./../../../../module1/src/main/java/com/example/app"
"../../../../module1/src/main/java/com/example/app"
"../../../../module1/src/main/java"
".\\..\\..\\..\\..\\module1\\src\\main\\java\\com\\example\\app"
".\\..\\..\\..\\..\\module1\\src\\main\\java"
"..\\..\\..\\..\\module1\\src\\main\\java\\com\\example\\app"
"..\\..\\..\\..\\module1\\src\\main\\java"

is there anything else required to be added in gradle dependencies?
i mean do i need to add dokka library to module1 separately? or it is included as dokka-commandLine in orchid?

I've joined Gitter chat, i hope we'll figure it out soon
thanks for the instruction

It seems like you've got it set up correctly. Since you have the kotlindocPackages and kotlindocClasses being created and there are no errors, the plugin should be installed correctly. And the file paths also look correct, it should be able to use either forward or back-slashes for the path.

Try running ./gradlew clean :docs:orchidServe instead of ./gradlew :docs:orchidServe as listed in the tutorial. The clean task will get rid of cached outputs which may be causing this issue.

kotlindoc component was mistakenly placed under "menu" component
thank you for your guide
i really appreciate your efforts on this library
it's a clean and robust way to have all of the documents in one place

Code of Conduct Report abuse