加备案号

.drone.yml

@@ -10,15 +10,16 @@ steps:
   - name: htmlDir
     path: /htmlDir
   commands:
+  # 生成html
   - mvn clean generate-resources -B -V
-  - ls src
-  - ls src/main
-  - tree src
-  # 替换 css、js 为国内七牛云 cdn 地址
+  # 加备案号
+  - find target/shoulder-specs/ -type f -name "*.html" | xargs sed -i 's#<div id="footer-text">#<div id="footer-text"><a href="https://beian.miit.gov.cn/" target="_blank">鲁ICP备20024731号-1</a>#g'
+  # 国内访问加速: 替换 css、js 为国内七牛云 cdn 地址
   - find target/shoulder-specs/ -type f -name "*.html" | xargs sed -i 's#cdnjs.cloudflare.com/ajax/libs#cdn.staticfile.org#g'
-  # 替换 google 字体地址为 其他的
+  # 国内访问加速: 替换 google 字体地址为 其他的
   - find target/shoulder-specs/ -type f -name "*.html" | xargs sed -i 's#fonts.googleapis.com#fonts.cat.net#g'
   #- sed -i "s!cdnjs.cloudflare.com/ajax/libs!cdn.staticfile.org!g" `grep cdnjs.cloudflare -rl target/shoulder-specs/`
+  # 搬运到web目录（目前不会删除历史文档，只有更新）
   - cp -r target/shoulder-specs/* /htmlDir
   
 - name: 钉钉通知

README.md

@@ -1,3 +1,34 @@
 # shoulder-dev-specs
 
-shoulder 的开发规范。
+shoulder 的开发规范。
+
+```bash
+L:\baseEnvironment\Toolbox\apps\IDEA-U\ch-0\232.8660.185\plugins\maven\lib\maven3\bin\mvn generate-resources
+```
+
+# 踩坑记录
+
+## 坑：【2021 java16就开始有了，现在还没解决】
+翻asciidoctor github issue 发现；去除 jruby 主动依赖解决（本身是可选的）
+
+WARN FilenoUtil : Native subprocess control requires open access to the JDK IO subsystem
+Pass '--add-opens java.base/sun.nio.ch=ALL-UNNAMED --add-opens java.base/java.io=ALL-UNNAMED' to enable.
+
+JRuby 的代码导致：
+asciidoctor-issue https://github.com/asciidoctor/asciidoctor-maven-plugin/issues/553
+https://github.com/asciidoctor/asciidoctorj/issues/1035
+
+jruby-issue
+https://github.com/jruby/jruby/issues/6721
+
+提到是JDK的安全更新但未提供替代方法原因
+
+## 坑2： asciidoctor adoc 源文件默认路径调整过
+翻asciidoctor github README解决
+
+最早：默认指向 ${basedir}/src/main/asciidoc
+
+后来：默认指向 ${basedir}/src/site/asciidoc
+
+## 坑3： java.lang.NoSuchFieldError: STRIO_READABLE
+去除 jruby 主动依赖解决（本身是可选的）

pom.xml

@@ -21,6 +21,7 @@
         <asciidoctorj.version>2023.26</asciidoctorj.version>
         <asciidoctorj-diagram.version>2.2.10</asciidoctorj-diagram.version>
         <asciidoctorj-pdf.version>2.3.9</asciidoctorj-pdf.version>
+        <spring-asciidoctor-backends.version>0.0.6</spring-asciidoctor-backends.version>
         <jruby.version>9.4.3.0</jruby.version>
 
     </properties>
@@ -49,10 +50,15 @@
                 <configuration>
                     <!--<outputDirectory>${project.build.directory}/shoulder-specs/${project.version}</outputDirectory>-->
                     <outputDirectory>${project.build.directory}/shoulder-specs</outputDirectory>
+
+                    <!-- 默认是所有文件-->
                     <!--<sourceDocumentName>book.adoc</sourceDocumentName>
                     <imagesDir>./</imagesDir>-->
+
+                    <!--                    不在将所有文件都生成到同一个目录中，而是将输出文件生成到相同的目录结构中。-->
                     <preserveDirectories>true</preserveDirectories>
-                    <sourceDirectory>src/docs/asciidoc/generated</sourceDirectory>
+                    <!--                    -->
+                    <sourceDirectory>${basedir}/src/main/asciidoc</sourceDirectory>
                     <attributes>
                         <endpoint-url>http://example.org</endpoint-url>
                         <sourcedir>${project.build.sourceDirectory}</sourcedir>
@@ -72,9 +78,12 @@
                         </goals>
                         <configuration>
                             <backend>html5</backend>
+                            <embedAssets>true</embedAssets>
+
                             <!-- coderay prettify -->
-                            <sourceHighlighter>coderay</sourceHighlighter>
                             <attributes>
+                                <!--                                <backend>spring-html</backend>-->
+                                <sourceHighlighter>coderay</sourceHighlighter>
                                 <imagesdir>/images</imagesdir>
                                 <toc>left</toc>
                                 <icons>font</icons>
@@ -114,57 +123,40 @@
                     </execution>-->
                 </executions>
                 <dependencies>
-                    <!-- Comment this section to use the default jruby artifact provided by the plugin -->
-                    <dependency>
-                        <groupId>org.jruby</groupId>
-                        <artifactId>jruby-complete</artifactId>
-                        <version>${jruby.version}</version>
-                    </dependency>
+
+                    <!-- OPTIONAL Comment this section to use the default jruby artifact provided by the plugin -->
+<!--                    <dependency>-->
+<!--                        <groupId>org.jruby</groupId>-->
+<!--                        <artifactId>jruby-complete</artifactId>-->
+<!--                        <version>${jruby.version}</version>-->
+<!--                    </dependency>-->
                     <!-- Comment this section to use the default AsciidoctorJ artifact provided by the plugin -->
                     <!--<dependency>
                         <groupId>org.asciidoctor</groupId>
                         <artifactId>asciidoctorj</artifactId>
                         <version>${asciidoctorj.version}</version>
                     </dependency>-->
+
                     <dependency>
                         <groupId>org.asciidoctor</groupId>
                         <artifactId>asciidoctorj-diagram</artifactId>
                         <version>${asciidoctorj-diagram.version}</version>
                     </dependency>
-                    <dependency>
+
+                    <!--<dependency>
                         <groupId>org.asciidoctor</groupId>
                         <artifactId>asciidoctorj-pdf</artifactId>
                         <version>${asciidoctorj-pdf.version}</version>
-                    </dependency>
+                    </dependency>-->
+                    <!--                    <dependency>-->
+                    <!--                        <groupId>io.spring.asciidoctor.backends</groupId>-->
+                    <!--                        <artifactId>spring-asciidoctor-backends</artifactId>-->
+                    <!--                        <version>${spring-asciidoctor-backends.version}</version>-->
+                    <!--                    </dependency>-->
+
                 </dependencies>
             </plugin>
 
-
-            <!--打包插件-->
-            <!--<plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-assembly-plugin</artifactId>
-                <executions>
-                    <execution>
-                        <id>assemble</id>
-                        <phase>package</phase>
-                        <goals>
-                            <goal>single</goal>
-                        </goals>
-                        <configuration>
-                            <descriptors>
-                                <descriptor>assembly.xml</descriptor>
-                            </descriptors>
-                            &lt;!&ndash;<recompressZippedFiles>true</recompressZippedFiles>&ndash;&gt;
-                            <finalName>shoulder-specs-${project.version}</finalName>
-                            <appendAssemblyId>false</appendAssemblyId>
-                            <outputDirectory>target/</outputDirectory>
-                            <workDirectory>target/assembly/work</workDirectory>
-                            <tarLongFileMode>gnu</tarLongFileMode>
-                        </configuration>
-                    </execution>
-                </executions>
-            </plugin>-->
         </plugins>
     </build>