[flume] Website upgrade? (building the current site fails)

2023-12-09 Thread Christian Grobmeier
Hi,

I work with flume-site, which uses Sphinx.

Unfortunately, I cannot build the site because of the message below.
A quick search gave me this issue:
https://github.com/prestodb/presto/issues/3849

I am assuming now that Sphinx does not support mkdirs on my system (Mac).

Digging deeper, I saw this error might be fixed in more recent versions since 
the current maven plugin did not see an update in 10 years:
https://mvnrepository.com/artifact/org.tomdz.maven/sphinx-maven-plugin

It seems there is a successor, that was not active for a few years too:

https://trustin.github.io/sphinx-maven-plugin/basic-usage.html
https://mvnrepository.com/artifact/kr.motd.maven/sphinx-maven-plugin

I could do the following:

1) let somebody else run mvn package, in the hope Sphinx works there
2) try to upgrade to the other Sphinx plugin, that also seems not maintained, 
but maybe works
3) create a Docker container, so it is independent of my operating system
4) replace it with something else (I would propose what I use with logging site)
5) make this repo redirect to logging.apache.org/flume and transfer all content 
the logging-site repository

What do you think? Ilike 5) most, to be honest (less things to deal with)

Kind regards,
Christian


# Sphinx version: 1.1.2
# Python version: 2.5.2
# Docutils version: 0.8.1 release
# Jinja2 version: 2.6
Traceback (most recent call last):
...
  File "/ASF/flume-site/target/sphinx/sphinx/util/osutil.py", line 55, in 
ensuredir
os.makedirs(path)
  File 
"~/.m2/repository/org/python/jython-standalone/2.5.2/jython-standalone-2.5.2.jar/Lib/os.py",
 line 158, in makedirs
mkdir(name, mode)
OSError: [Errno 2] Unknown error: 2: '/ASF/flume-site/target/site'



Re: [flume] Website upgrade? (building the current site fails)

2023-12-09 Thread Ralph Goers
Obviously, I have never had a problem building the Flume web site, although I 
haven’t done it since the last release. I just ran the build with no problems.

Did you follow the instructions at 
https://cwiki.apache.org/confluence/display/FLUME/Updating+the+Web+Site? I 
don’t know why it would be using Sphinx 1.1.2. For me it has always used 1.1.3.

To be honest I am not a fan of Sphinx or restructured text markup language. I 
would love to redo the whole site. I also have always hated the logo. It is 
supposed to be a log coming down a chute (i.e. a flume) but to me it looks like 
a giant snail. I would love to see that redone with something that really looks 
like a log coming down a chute.

FYI - here is the output of mvn dependency:resolve-plugins for the sphinx plugin

[INFO]org.tomdz.maven:sphinx-maven-plugin:maven-plugin:1.0.3:runtime
[INFO]   org.tomdz.maven:sphinx-maven-plugin:jar:1.0.3
[INFO]   org.apache.maven.reporting:maven-reporting-api:jar:3.0
[INFO]   org.apache.maven.doxia:doxia-sink-api:jar:1.0
[INFO]   org.apache.maven.reporting:maven-reporting-impl:jar:2.0.5
[INFO]   org.apache.maven:maven-project:jar:2.0.6
[INFO]   org.apache.maven:maven-settings:jar:2.0.6
[INFO]   org.apache.maven:maven-profile:jar:2.0.6
[INFO]   org.apache.maven:maven-model:jar:2.0.6
[INFO]   org.apache.maven:maven-artifact-manager:jar:2.0.6
[INFO]   org.apache.maven:maven-repository-metadata:jar:2.0.6
[INFO]   org.apache.maven.wagon:wagon-provider-api:jar:1.0-beta-2
[INFO]   org.apache.maven:maven-plugin-registry:jar:2.0.6
[INFO]   org.apache.maven:maven-plugin-api:jar:2.0.6
[INFO]   org.apache.maven.doxia:doxia-core:jar:1.0
[INFO]   org.apache.maven.doxia:doxia-site-renderer:jar:1.0
[INFO]   org.codehaus.plexus:plexus-i18n:jar:1.0-beta-7
[INFO]   org.codehaus.plexus:plexus-velocity:jar:1.1.7
[INFO]   org.apache.velocity:velocity:jar:1.5
[INFO]   commons-lang:commons-lang:jar:2.1
[INFO]   org.apache.maven.doxia:doxia-decoration-model:jar:1.0
[INFO]   commons-collections:commons-collections:jar:3.2
[INFO]   org.apache.maven.doxia:doxia-module-apt:jar:1.0
[INFO]   org.apache.maven.doxia:doxia-module-fml:jar:1.0
[INFO]   org.apache.maven.doxia:doxia-module-xdoc:jar:1.0
[INFO]   org.apache.maven.doxia:doxia-module-xhtml:jar:1.0
[INFO]   org.apache.maven.shared:maven-doxia-tools:jar:1.0.2
[INFO]   commons-validator:commons-validator:jar:1.2.0
[INFO]   commons-beanutils:commons-beanutils:jar:1.7.0
[INFO]   commons-digester:commons-digester:jar:1.6
[INFO]   commons-logging:commons-logging:jar:1.0.4
[INFO]   oro:oro:jar:2.0.8
[INFO]   xml-apis:xml-apis:jar:1.0.b2
[INFO]   org.codehaus.plexus:plexus-utils:jar:1.5.8
[INFO]   org.apache.maven:maven-plugin-descriptor:jar:2.2.1
[INFO]   org.apache.maven:maven-artifact:jar:2.2.1
[INFO]   
org.codehaus.plexus:plexus-container-default:jar:1.0-alpha-9-stable-1
[INFO]   junit:junit:jar:3.8.1
[INFO]   classworlds:classworlds:jar:1.1-alpha-2
[INFO]   org.apache.commons:commons-compress:jar:1.1
[INFO]   commons-io:commons-io:jar:1.3.2
[INFO]   org.python:jython-standalone:jar:2.5.2



> On Dec 9, 2023, at 9:00 AM, Christian Grobmeier  wrote:
> 
> Hi,
> 
> I work with flume-site, which uses Sphinx.
> 
> Unfortunately, I cannot build the site because of the message below.
> A quick search gave me this issue:
> https://github.com/prestodb/presto/issues/3849
> 
> I am assuming now that Sphinx does not support mkdirs on my system (Mac).
> 
> Digging deeper, I saw this error might be fixed in more recent versions since 
> the current maven plugin did not see an update in 10 years:
> https://mvnrepository.com/artifact/org.tomdz.maven/sphinx-maven-plugin
> 
> It seems there is a successor, that was not active for a few years too:
> 
> https://trustin.github.io/sphinx-maven-plugin/basic-usage.html
> https://mvnrepository.com/artifact/kr.motd.maven/sphinx-maven-plugin
> 
> I could do the following:
> 
> 1) let somebody else run mvn package, in the hope Sphinx works there
> 2) try to upgrade to the other Sphinx plugin, that also seems not maintained, 
> but maybe works
> 3) create a Docker container, so it is independent of my operating system
> 4) replace it with something else (I would propose what I use with logging 
> site)
> 5) make this repo redirect to logging.apache.org/flume and transfer all 
> content the logging-site repository
> 
> What do you think? Ilike 5) most, to be honest (less things to deal with)
> 
> Kind regards,
> Christian
> 
> 
> # Sphinx version: 1.1.2
> # Python version: 2.5.2
> # Docutils version: 0.8.1 release
> # Jinja2 version: 2.6
> Traceback (most recent call last):
> ...
>  File "/ASF/flume-site/target/sphinx/sphinx/util/osutil.py", line 55, in 
> ensuredir
>os.makedirs(path)
>  File 
> "~/.m2/repository/org/python/jython-standalone/2.5.2/jython-standalone-2.5.2.jar/Lib/os.py",
>  line 158, in m

Re: [flume] Website upgrade? (building the current site fails)

2023-12-09 Thread Christian Grobmeier


On Sat, Dec 9, 2023, at 17:30, Ralph Goers wrote:
> Did you follow the instructions at 
> https://cwiki.apache.org/confluence/display/FLUME/Updating+the+Web+Site? 
> I don’t know why it would be using Sphinx 1.1.2. 

Yes, I was failing at step 4 (mvn package)
I think, it is the underlying Python libraries, they don't support non-Windows 
OS, but I have no proof

> For me it has always  used 1.1.3.

It is running Sphinx v1.1.3 after I upgraded to Sphinx-Maven plugin 1.0.3 - but 
no success.


> To be honest I am not a fan of Sphinx or restructured text markup 
> language. I would love to redo the whole site. I also have always hated 
> the logo. It is supposed to be a log coming down a chute (i.e. a flume) 
> but to me it looks like a giant snail. I would love to see that redone 
> with something that really looks like a log coming down a chute.

Oh no, now I can see the snail too :)

I am happy with making it different and even integrating it into logging-site. 
It should be trivial, and Flume can keep its template. I cannot easily update 
the logo, but we can quickly improve the general look and feel.

Let me know if you agree with using logging-site for this content; then I start 
migrating everything from RST.

> FYI - here is the output of mvn dependency:resolve-plugins for the sphinx 
> plugin

Yes, it is the same for me. I guess my Mac is the problem :-)


Re: [flume] Website upgrade? (building the current site fails)

2023-12-09 Thread Ralph Goers


> On Dec 9, 2023, at 3:27 PM, Christian Grobmeier  wrote:
> 
> 
> On Sat, Dec 9, 2023, at 17:30, Ralph Goers wrote:
>> Did you follow the instructions at 
>> https://cwiki.apache.org/confluence/display/FLUME/Updating+the+Web+Site? 
>> I don’t know why it would be using Sphinx 1.1.2. 
> 
> Yes, I was failing at step 4 (mvn package)
> I think, it is the underlying Python libraries, they don't support 
> non-Windows OS, but I have no proof

I have always used MacOS so that cannot be it.


> 
>> For me it has always  used 1.1.3.
> 
> It is running Sphinx v1.1.3 after I upgraded to Sphinx-Maven plugin 1.0.3 - 
> but no success.

Why did you need to upgrade?  1.0.3 is specified in the pom.xml. 

> 
> 
>> To be honest I am not a fan of Sphinx or restructured text markup 
>> language. I would love to redo the whole site. I also have always hated 
>> the logo. It is supposed to be a log coming down a chute (i.e. a flume) 
>> but to me it looks like a giant snail. I would love to see that redone 
>> with something that really looks like a log coming down a chute.
> 
> Oh no, now I can see the snail too :)
> 
> I am happy with making it different and even integrating it into 
> logging-site. It should be trivial, and Flume can keep its template. I cannot 
> easily update the logo, but we can quickly improve the general look and feel.
> 
> Let me know if you agree with using logging-site for this content; then I 
> start migrating everything from RST.

Yes, it should reside at logging.apache.org/flume 
. flume.apache.org  
should redirect to that.

> 
>> FYI - here is the output of mvn dependency:resolve-plugins for the sphinx 
>> plugin
> 
> Yes, it is the same for me. I guess my Mac is the problem :-)

I don’t see how. As I said, I have always used a Mac. Are you using JDK 11? 

The python libraries I have installed on my machine are 

python
Python 2.7.18 (v2.7.18:8d21aa21f2, Apr 19 2020, 20:48:48) 
[GCC 4.2.1 Compatible Apple LLVM 6.0 (clang-600.0.57)] on darwin
Type "help", "copyright", "credits" or "license" for more information.

That said, I am not sure these even get used. The maven plugin has Jython 
embedded in it.

I have a theory. In looking at my Java installs they all appear to be x86 
(which runs fine on an m2 Mac). I will try tomorrow on my Mac Studio which has 
the arm JDKs installed.

Ralph