I need ur help again. :) for index file for blog folder I tried to set using Taxonomy but nothing working for me in your free time could you please send up for me? https://github.com/rajmahendra/OrchidTestBlog
I like to have title, date , author and feature image in that
with pagination.
@rajmahendra I opened another PR. Just a small tweak to the configuration for generating paginated post archives, and updating the post list template to use the same one as used on the sample theme homepage
Hello, everyone! I experience a problem with missing links on documentation pages. I am running OrchidTutorials/kotlin-site sample project and observing no link on classes on com.package doc page: !(https://www.dropbox.com/s/5lqsno4m2ib5qrx/img1.png?dl=0)
Same happens when building my own site, but I am using Javadoc there.
Same happens when building my own site, but I am using Javadoc there.
@qradimir Orchid doesn't currently link to the stdlib docs, there's an open issue for this #237. It should be creating a link to
Application, so I'll have to take a look to know what's going on there
@weylar There's nothing specific or different for an Android project. You'll need to make a separate subproject for Orchid since it uses the Java Gradle plugin, but beyond that you'll just point Orchid to your Java/Kotlin code from the main project as normal
Menu items can't be sorted, currently, but it is a very good idea! I've created #381 for it. And no, Orchid doesn't support relative URLs for viewing directly from the filesystem, though it is one of the most-requested features and one of my highest-priority items. There's just a lot of infrastructural work that needs to be done to support it, but I am working on it, though I don't have an estimate of when it would be available
@cjbrooks12
I'm having this error in admin:
Error loading the CMS configuration
Config Errors:
'collections[0].files[0].fields[2].types[2].fields' fields names must be unique
'collections[0].files[0].fields[2].types[6].fields[3].fields' should NOT have fewer than 1 items
...
Check your config.yml file.my orchid version is : 0.16.10
Good morning! Just wanted to ask since I'm unsure based on the docs.
I'm currently developing a command handling framework, and working on making a small documentation generator, hopefully with results comparble to Spring REST Docs.
Is Orchid a suitable solution for this, if I wanted to export all commands as files with Asciidoctor, and then have Orchid generate the static website?
Hi Everyone, I'm getting this issue, this is my first run with orchid, could you please help me? orchidhq/Orchid#382
Hey. I was interested in using this software to build some documentation for my Java project. But I don't have really the knowledge of what I need to look at (e.g. if there are any files I have to create first or if I have to download something first) to make this work for me, so a bit of assistance would be greatly appeciated.
Basically, do I want to generate Javadocs (and also some markdown wiki pages) using Orchid. My project is made in java (not kotlin) and I'm currently in the process of splitting it up into several modules.
Basically, do I want to generate Javadocs (and also some markdown wiki pages) using Orchid. My project is made in java (not kotlin) and I'm currently in the process of splitting it up into several modules.
@javaherisaber That looks like an error with the NetlifyCMS, I'll have to look into what's going on there. If you aren't using that, you can remove the plugin and it will be fine. Also, You're on an older version of Orchid, so you might see if the issue is still there on newer versions
@Andre601 Orchid is run as a Gradle or a Maven plugin, and it works with Java in the exact same way that it does with Kotlin. The code documentation tutorial walks you through getting it set up for Kotlin, but you can pretty much just replace "kotlin" with " java" throughout that tutorial and have it work for you. You can also look at the java-site tutorial repo to see how it's set up with Gradle, which should follow the linked tutorial as well
I checked both pages, but still run into the issue I described in my issue posted here: orchidhq/Orchid#384
[Javadoc related]
I was looking over the examples, and read through a few issues and RFEs - I could not find whether or not it was supported to generate javadoc from a dependency rather than having the source code in the documentation project. We have documentation spread across multiple projects and multiple modules within those projects
I was looking over the examples, and read through a few issues and RFEs - I could not find whether or not it was supported to generate javadoc from a dependency rather than having the source code in the documentation project. We have documentation spread across multiple projects and multiple modules within those projects
There were a two errors/warning when I built from Git https://gist.github.com/sudhirkhanger/1a0d0911399c2d62c788962f2704a84e
@stmty9 You can configure the archive pages (the ones listing links to the gathered pages), but you can't configure the individual pages that are gathered into a taxonomy. There's a circular dependency there: the pages need to be built and configured before they can be gathered into taxonomies, so the taxonomies can't also go configure the pages. You're better-off using the pages plugin to set up and configure the pages you want, and then using the collection archives to make the archive pages based on those page groups.
@sudhirkhanger Custom themes in Orchid are basically just Pebble templates over normal HTML. You'd need to be familiar with HTML and CSS (and optionally JS for more interactive elements) to make a custom theme. It's also helpful to be pretty familiar with Orchid itself using an existing theme: trying to create a theme without first understanding how Orchid does things and it's specific additions to Pebble templates will be difficult, the theming system just isn't at a point yet to really be easily done without some more advanced knowledge of Orchid
As for the errors on the quickstart repo, it's been orchidhq/OrchidStarter#9, I just haven't had time to fix it yet. But if you try using the Editorial theme it should work for you
Hi! Is there any way to include content of another file (source code) into a static (wiki) page? We some code examples on our static pages. We would like to put the example code in real source files to benefit from refactoring abilities in the IDE. So if it's possible it would be great if you could use some include tag (from pebble) to include contents of other files. Does anyone know how to do this?
@ola-jayway The Snippets plugin is what you're looking for. With it, you'll be able to add comment regions into your source or unit test files, and Orchid will scan those files and make it easy to embed what it finds
Hi! I'm working on adding orchid to our project, and followed the setup guide exactly. I had it working months in the past but I believe something has changed in our app that's now causing it not to work. I'm getting the error "The 'java' plugin has been applied, but it is not compatible with the Android plugins."
I've researched everything I could find but haven't had any luck on fixing it so far. Any idea of what could be going wrong?
I've researched everything I could find but haven't had any luck on fixing it so far. Any idea of what could be going wrong?
Orchid can't be used in the same Gradle subproject as an Android project (one that has
apply plugin: "com.android.library" or apply plugin: "com.android.application" in it). This has always been the case as the Android Gradle plugins do not use the Java plugin toolchain. For Android projects, you'll have to move it to another subproject like :docs and update the paths to the java/kotlin sources to the main project directory, which is the best practice anyway. You can see an example of this in all the repos I maintain and use Orchid in, such as copper-leaf/clog or orchidhq/Orchid itself.
I have added the following rows to a typescript file:
// snippet::snippet-init-createviewer
createMethod() {
console.log("I create something");
}
// end::snippet-init-createviewer
And I have added the following config to config.yml:
snippets:
sections:
- tags: ['embedded_snippets']
adapter:
type: 'embedded'
baseDirs: ['./../../../../minimal-viable-product/src']
recursive: trueBut I can not get anything to be seen in the list in /admin/snippets.
I have tried both absolute and every possible combination of relative paths for baseDirs.
Is there something else I need to do as well to catch my little code-snippet?
The docs and the code is in two different modules.
I'm guessing the path isn't quite right. The baseDirs path should be relative to the
config.yml file. You can test you have the right path by cd-ing to the directory with your config.yml file, and do ls ./../../../../minimal-viable-product/src and see if it lists the files/folder you're expecting (and adjusting the relative pathing if necessary until it does)
