MyBatis online english manual is blank,   Chinese manual is partially visible, Please check the source code! MyBatis online english manual is blank,   Chinese manual is partially visible, Please check the source code!

Comment From: awxiaoxian2020

Related to https://github.com/mybatis/parent/issues/600

Comment From: AgostinoX

I confirm that I cannot read content (english version).

Comment From: Jason7158

Also need the annotation documentation!

Comment From: Hugh-Ross4

Lots of people impacted by this. Any alternative links to MyBatis-3 documentation that are still working? Thanks..

Comment From: harawata

Hi,

I'm sorry for the inconvenience. I think @hazendaz is working on it.

For the meantime, please use the wayback machine. https://web.archive.org/web/20240303085253/https://mybatis.org/mybatis-3/index.html

Or you can build the site locally.

git clone https://github.com/mybatis/mybatis-3.git
cd mybatis-3
git checkout mybatis-3.5.16
./mvnw clean site -Dlicense.skip=true -Dmaven.test.skip=true

The HTMLs will be generated in ./target/site/ directory.

I would recommend modifying the locales in the pom.xml to shorten the build time.

diff --git a/pom.xml b/pom.xml
index a8413790a2..43ce196258 100644
--- a/pom.xml
+++ b/pom.xml
@@ -442,7 +442,7 @@
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-site-plugin</artifactId>
         <configuration>
-          <locales>default,es,ja,fr,zh_CN,ko</locales>
+          <locales>default</locales>
         </configuration>
       </plugin>
       <plugin>

Comment From: hazendaz

@harawata I did run the 'site' GHA and it ran ok, the files were updated, but noticed the site never published to org.mybatis. Do you know if there is something else missing there or maybe does it exclude showing snapshots? I'd hate to do a formal release with really no reason other than site but if that is the case, we probably could do so but in that case, let me release the parent again to pickup a few additional items from maven. I know this could be worse, maven broke half their sites documentation due to using maven 4 to run the site for 3. Not the case here but seems documentation problems all over.

Comment From: harawata

@hazendaz ,

When I ran ./mvnw site against the master locally, the English site is blank (same as the online site), so I assumed that there was some issue with Markdown processor. Does it generate the site correctly on your machine?

Comment From: hazendaz

Thanks @harawata I'll give a try in a few days. Maybe the original defect that resulting in changing the locales is now fixed again. Maven is having a bumpy right here. It is nice to see its problematic locally so I'll give it a shot and see what I can come up with. Will be this coming weekend..

Comment From: harawata

I have reverted the site to 3.5.16 version, so it should be fine for now. If someone finds a way to fix the blank site, please send us a PR.

Comment From: awxiaoxian2020

Maybe related to https://maven.apache.org/docs/3.9.8/release-notes.html#potentially-breaking-core-changes-if-migrating-from-3-8-x

Comment From: hazendaz

Latest site is posted, I think this is fixed, can @wyzhihai confirm its working correctly now?

Comment From: awxiaoxian2020

Latest site is posted, I think this is fixed, can @wyzhihai confirm its working correctly now?

I think #3194 just a workaround. Maybe we should open this for more information.