Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Activity
    Sachin Mukherjee
    @sachinmukherjee
    Where can i find the source code of https://wiki.jenkins.io/display/JENKINS/Internationalization and https://jenkins.io/ ?
    Marky Jackson
    @markyjackson-taulia
    https://github.com/jenkins-infra/jenkins.io
    Mark Waite
    @MarkEWaite
    @sachinmukherjee the source of the wiki page is on the wiki page itself, available by editing the wiki page. The source for https://jenkins.io/ is https://github.com/jenkins-infra/jenkins.io/ and is available from the "Improve this page" at the bottom of each page on jenkins.io.
    Sachin Mukherjee
    @sachinmukherjee
    Currently this URL http://localhost:4242/doc/developer/internationalization/ return some page named Internationalization and Localization. How should I change the default page of this URL?
    Mark Waite
    @MarkEWaite
    @sachinmukherjee if you navigate to that page on the jenkins.io site, you'll find an "Improve this page" in the lower left area of the page. Click that link and it will take you to the page in GitHub. I believe that specific page is https://github.com/jenkins-infra/jenkins.io/edit/master/content//doc/developer/internationalization/index.adoc
    Sachin Mukherjee
    @sachinmukherjee
    @MarkEWaite Thanks. I have fixed that issue. I was trying to migrate the old internationalization page from wiki to doc/developer/internationalization/ for that i have added a new file inside internationalization folder named new-internationalization.adoc and added the file name inside the sections for _chapter.yml file. but it is giving me error
    undefined methodmatch' for nil:NilClass
    Rendering file /home/sachinmukherjee/Coading/OpenSource/jenkins.io/content/_partials/toptoolbar.html.haml resulted in a failure.`
    Tim Jacomb
    @timja
    I get that all the time when I add a new page @sachinmukherjee
    I always have to restart the preview server
    i.e. do make run again
    Also happens if I change any of the ruby code in the website at all :(
    PR for adjusting the navigation in the developer book:
    jenkins-infra/jenkins.io#2580
    Sachin Mukherjee
    @sachinmukherjee
    @timja Tried re running the server again but still getting undefined method[]' for nil:NilClass`
    Mark Waite
    @MarkEWaite

    @sachinmukherjee I just ran a lightweight experiment in that directory and confirmed that if I copy the advanced-localization.adoc file to test-localization.adoc then replace each occurrence of 'advanced' with 'test', and add 'test-localization' to the _chapter.yml, then I see the same message in the current running make run window that you saw (and that @timja confirmed). When I stop the make run and restart it, then the 'test-localization' is included in the top level chapter page and it displays correctly when I click the link.

    Did you possibly include the .adoc suffix on the filename when you inserted it into the _chapter.yml file?

    Tim Jacomb
    @timja
    @MarkEWaite @sachinmukherjee
    Fix for that:
    jenkins-infra/jenkins.io#2582
    urwa
    @urwa

    Hi,

    I have picked this issue: https://issues.jenkins-ci.org/browse/WEBSITE-664

    These are the steps I have taken:

    • Created a local clone.
    • Created a new file in content/participate/ with material from the slides mentioned in the issue tracker.
    • Then I updated index.html.haml by adding a link to the above file in the Testing section.
    Now I am going to setup the building process as mentioned here:
    https://github.com/jenkins-infra/jenkins.io/blob/master/CONTRIBUTING.adoc#building
    I just want to know if I am going in the right direction.
    Oleg Nenashev
    @oleg-nenashev
    @urwa looks so
    urwa
    @urwa
    Thanks, will keep going then.
    Sachin Mukherjee
    @sachinmukherjee
    @MarkEWaite It worked finally. Thanks
    Sachin Mukherjee
    @sachinmukherjee
    I have put all the images for new internationalization page inside /content/images/developer/internationalization/a.png directory. But somehow the image is not loading in the adoc file. I have written this code for image attribute image:../content/images/developer/internationalization/a.png[image,title="Jenkins > Internationalization > before.png"] my image file name is a.png
    urwa
    @urwa

    Hi,
    I ran make all in my jenkins.io cloned directory and I get the following output:

    mkdir -p build/_site chmod u+x scripts/groovy scripts/ruby scripts/node scripts/asciidoctor-pdf scripts/awestruct scripts/user-site-deploy.sh scripts/release.rss.groovy scripts/fetch-external-resources scripts/check-broken-links mkdir -p vendor/gems ./scripts/ruby pull ./scripts/ruby bundle install --path=vendor/gems mkdir -p content/_tmp ./scripts/groovy pull ./scripts/groovy scripts/release.rss.groovy 'https://updates.jenkins.io/release-history.json' > build/_site/releases.rss ./scripts/ruby bundle exec ./scripts/fetch-external-resources mkdir -p node_modules ./scripts/node pull ./scripts/node npm install mkdir -p build/_site/assets/bower/anchor-js/ cp node_modules/anchor-js/*.js build/_site/assets/bower/anchor-js/ mkdir -p build/_site/assets/bower/ionicons cp -R node_modules/ionicons/dist/css build/_site/assets/bower/ionicons cp -R node_modules/ionicons/dist/fonts build/_site/assets/bower/ionicons ./scripts/awestruct --generate --verbose --source-dir=content --output-dir=build/_site mkdir -p build/archives (cd build && \ rm -f archives/jenkins.io--12c39441.zip && \ ln -f -s _site jenkins.io--12c39441 && \ zip --quiet -r archives/jenkins.io--12c39441.zip jenkins.io--12c39441)

    But http://localhost:4242/ shows unable to connect

    As a result of the create directory commands mkdir and copy commands cp, I do not see any changes in my directory jenkins.io

    Can anyone help, what I might be doing wrong.
    Tim Jacomb
    @timja
    you need make run for previewing it locally
    urwa
    @urwa

    Oh about that, I ran the list of commands here:
    https://github.com/jenkins-infra/jenkins.io/blob/master/CONTRIBUTING.adoc#make-targets
    And they get stuck at random points. I can not pin point what particular command it gets stuck at since it varies.

    What I mean to say, for example when I run make run

    • Sometimes it gets stuck at
      mkdir -p build/_site chmod u+x scripts/groovy scripts/ruby scripts/node scripts/asciidoctor-pdf scripts/awestruct scripts/user-site-deploy.sh scripts/release.rss.groovy scripts/fetch-external-resources scripts/check-broken-links mkdir -p vendor/gems ./scripts/ruby pull ./scripts/ruby bundle install --path=vendor/gems mkdir -p content/_tmp ./scripts/groovy pull ./scripts/groovy scripts/release.rss.groovy 'https://updates.jenkins.io/release-history.json' > build/_site/releases.rss ./scripts/ruby bundle exec ./scripts/fetch-external-resources mkdir -p node_modules ./scripts/node pull ./scripts/node npm install mkdir -p build/_site/assets/bower/anchor-js/ cp node_modules/anchor-js/*.js build/_site/assets/bower/anchor-js/ mkdir -p build/_site/assets/bower/ionicons cp -R node_modules/ionicons/dist/css build/_site/assets/bower/ionicons
    • Sometimes it runs completely and still I do not see anything at localhost:4242
    Tim Jacomb
    @timja
    that doesn't look right
    this is what I see when I do make run 
    $ make run
LISTEN=true ./scripts/awestruct --dev --bind 0.0.0.0  --source-dir=content --output-dir=build/_site
Missing required dependency to activate optional built-in extension minify.rb
  cannot load such file -- htmlcompressor
Using profile: development
Generating site: http://localhost:4242/
Executing pipeline...
Loading solution pages
 = Imported solution /Users/timja/projects/jenkinsci/jenkins.io/content/solutions/android.adoc as /s/android/index.html
 = Imported solution /Users/timja/projects/jenkinsci/jenkins.io/content/solutions/c.adoc as /s/c/index.html
 = Imported solution /Users/timja/projects/jenkinsci/jenkins.io/content/solutions/docker.adoc as /s/docker/index.html
 = Imported solution /Users/timja/projects/jenkinsci/jenkins.io/content/solutions/embedded.adoc as /s/embedded/index.html
 = Imported solution /Users/timja/projects/jenkinsci/jenkins.io/content/solutions/github.adoc as /s/github/index.html
 = Imported solution /Users/timja/projects/jenkinsci/jenkins.io/content/solutions/java.adoc as /s/java/index.html
 = Imported solution /Users/timja/projects/jenkinsci/jenkins.io/content/solutions/php.adoc as /s/php/index.html
 = Imported solution /Users/timja/projects/jenkinsci/jenkins.io/content/solutions/pipeline.adoc as /s/pipeline/index.html
 = Imported solution /Users/timja/projects/jenkinsci/jenkins.io/content/solutions/python.adoc as /s/python/index.html
 = Imported solution /Users/timja/projects/jenkinsci/jenkins.io/content/solutions/ruby.adoc as /s/ruby/index.html
/doc/upgrade-guide/2.190/index.html
/doc/upgrade-guide/2.176/index.html
/doc/upgrade-guide/2.164/index.html
/doc/upgrade-guide/2.150/index.html
/doc/upgrade-guide/2.138/index.html
/doc/upgrade-guide/2.121/index.html
/doc/upgrade-guide/2.107/index.html
/doc/upgrade-guide/2.89/index.html
/doc/upgrade-guide/2.73/index.html
/doc/upgrade-guide/2.60/index.html
/doc/upgrade-guide/2.46/index.html
/doc/upgrade-guide/2.32/index.html
/doc/upgrade-guide/2.19/index.html
/doc/upgrade-guide/2.7/index.html
*************************************************************************
Starting preview server at http://0.0.0.0:4242 (Press Ctrl-C to shutdown)
*************************************************************************

13:17:54 - INFO - LiveReload is waiting for a browser to connect.
[2019-10-20 13:17:55] INFO  WEBrick 1.4.2
[2019-10-20 13:17:55] INFO  ruby 2.6.5 (2019-10-01) [x86_64-linux]
[2019-10-20 13:17:55] INFO  WEBrick::HTTPServer#start: pid=1 port=4242
    can you paste the full output and do proper code formatting 3 backticks to start and finish please
    ```
    urwa
    @urwa
    Z:\outreachy\jenkins\jenkins.io>make clean
git clean -Xfd
    Z:\outreachy\jenkins\jenkins.io>make prepare
mkdir -p build/_site
chmod u+x scripts/groovy scripts/ruby scripts/node scripts/asciidoctor-pdf scripts/awestruct scripts/user-site-deploy.sh scripts/release.rss.groovy scripts/fetch-external-resources scripts/check-broken-links
mkdir -p vendor/gems
./scripts/ruby pull
./scripts/ruby bundle install --path=vendor/gems
mkdir -p content/_tmp
./scripts/groovy pull
./scripts/groovy scripts/release.rss.groovy 'https://updates.jenkins.io/release-history.json' > build/_site/releases.rss
./scripts/ruby bundle exec ./scripts/fetch-external-resources
mkdir -p node_modules
./scripts/node pull
./scripts/node npm install
mkdir -p build/_site/assets/bower/anchor-js/
cp node_modules/anchor-js/*.js build/_site/assets/bower/anchor-js/
mkdir -p build/_site/assets/bower/ionicons
cp -R node_modules/ionicons/dist/css build/_site/assets/bower/ionicons
cp -R node_modules/ionicons/dist/fonts build/_site/assets/bower/ionicons
    Z:\outreachy\jenkins\jenkins.io>make generate
mkdir -p build/_site
chmod u+x scripts/groovy scripts/ruby scripts/node scripts/asciidoctor-pdf scripts/awestruct scripts/user-site-deploy.sh scripts/release.rss.groovy scripts/fetch-external-resources scripts/check-broken-links
mkdir -p vendor/gems
./scripts/ruby pull
./scripts/ruby bundle install --path=vendor/gems
mkdir -p content/_tmp
./scripts/groovy pull
./scripts/groovy scripts/release.rss.groovy 'https://updates.jenkins.io/release-history.json' > build/_site/releases.rss
./scripts/ruby bundle exec ./scripts/fetch-external-resources
mkdir -p node_modules
./scripts/node pull
./scripts/node npm install
mkdir -p build/_site/assets/bower/anchor-js/
cp node_modules/anchor-js/*.js build/_site/assets/bower/anchor-js/
mkdir -p build/_site/assets/bower/ionicons
cp -R node_modules/ionicons/dist/css build/_site/assets/bower/ionicons
cp -R node_modules/ionicons/dist/fonts build/_site/assets/bower/ionicons
./scripts/awestruct --generate --verbose --source-dir=content --output-dir=build/_site
    Z:\outreachy\jenkins\jenkins.io>make run
mkdir -p build/_site
chmod u+x scripts/groovy scripts/ruby scripts/node scripts/asciidoctor-pdf scripts/awestruct scripts/user-site-deploy.sh scripts/release.rss.groovy scripts/fetch-external-resources scripts/check-broken-links
mkdir -p vendor/gems
./scripts/ruby pull
./scripts/ruby bundle install --path=vendor/gems
mkdir -p content/_tmp
./scripts/groovy pull
./scripts/groovy scripts/release.rss.groovy 'https://updates.jenkins.io/release-history.json' > build/_site/releases.rss
./scripts/ruby bundle exec ./scripts/fetch-external-resources
mkdir -p node_modules
./scripts/node pull
./scripts/node npm install
mkdir -p build/_site/assets/bower/anchor-js/
cp node_modules/anchor-js/*.js build/_site/assets/bower/anchor-js/
mkdir -p build/_site/assets/bower/ionicons
cp -R node_modules/ionicons/dist/css build/_site/assets/bower/ionicons
cp -R node_modules/ionicons/dist/fonts build/_site/assets/bower/ionicons
LISTEN=true ./scripts/awestruct --dev --bind 0.0.0.0  --source-dir=content --output-dir=build/_site
    Tim Jacomb
    @timja
    you should just need make run
    but not sure why it's not working sorry
    urwa
    @urwa

    Thanks for the help though.

    Steps I did were:

    • git clone https://github.com/jenkins-infra/jenkins.io.git
    • added a new page content/participate/test.adoc
    • updated index.html.haml with link to above created page
    • then ran make all and make run

    may be i missed some step or did something wrong... just putting this info here if it provides some insight.

    Mark Waite
    @MarkEWaite

    I have put all the images for new internationalization page inside /content/images/developer/internationalization/a.png directory. But somehow the image is not loading in the adoc file. I have written this code for image attribute image:../content/images/developer/internationalization/a.png[image,title="Jenkins > Internationalization > before.png"] my image file name is a.png

    @sachinmukherjee I think image references always start with /images rather than /content/images

    @urwa I don't think anyone has done jenkins.io documentation development on Windows. I'm a Windows user, but I always run jenkins.io development environment on Linux. I suspect there are platform specific issues related to either differences in the behavior of make or in the behavior of portions of the site generation steps on Windows computers.
    Oleg Nenashev
    @oleg-nenashev
    @MarkEWaite @urwa I do develop jenkins.io on Windows, but I use WSL and Docker. https://nickjanetakis.com/blog/setting-up-docker-for-windows-and-wsl-to-work-flawlessly can be followed to bootstrap such setup
    Mark Waite
    @MarkEWaite
    Thanks @oleg-nenashev
    rajaws2015
    @rajaws2015
    Hi All, currently i am working on issue https://issues.jenkins-ci.org/browse/WEBSITE-647
    I have a question now :How to determine whether the documentation page comes from Markdown or Asciidoc?
    Oleg Nenashev
    @oleg-nenashev
    Discussed it with @rajaws2015 onsite
    urwa
    @urwa

    Hi @oleg-nenashev ,

    Thanks for your help. I had no idea about WSL and its amazing. I have set it up.
    Now I am having a small issue of \r carriage return since my local repo is on windows that I am trying to run through WSL.
    Here is the exact error:

    ./scripts/ruby pull
./scripts/ruby: line 2: $'\r': command not found
: No such file or directorycripts/docker-env
./scripts/ruby: line 5: $'\r': command not found
./scripts/ruby: line 8: syntax error near unexpected token `fi'
'/scripts/ruby: line 8: `fi;
Makefile:77: recipe for target 'build/ruby' failed
make: *** [build/ruby] Error 2

    I have come across two suggestions at the moment:

    option 1 seems like NOT the right option since it would be changing files in the repo that I believe I should not be doing.

    About option 2, since WSL is simply a CLI, so making changes in the local repo (creating file, updating file) won't be as simple as in VS Code.

    I just want to ask how does your setup look like while developing jenkins.io in windows.

    Thanks once again.

    Oleg Nenashev
    @oleg-nenashev
    @urwa My Git is configured to preserve the Unix line endings for repos. Ypu can put 'core.autocrlf=input' in settings, but likely you will need to re-clone the repo after it
    Philipp Nowak
    @literalplus
    @urwa what I usually use for that is a .gitattributes file that forces LF line endings on all *.sh files, since shell files don't run with CRLF anyways & most people that can run shell files use editors that can deal with LF. See this GitHub page for an example. There's also some way to migrate existing files via git add. Depends on the project whether this is an acceptable solution though
    urwa
    @urwa

    @oleg-nenashev and @xxyy thank you for your responses.

    While setting up WSL and struggling with permission issues across windows and ubuntu, I found out my system was infested with mining malware. After spending quite some time and failing miserably to fix it. I ended up letting windows go and beginning with a clean Ubuntu installation.

    This solved a lot of errors I kept googling for WSL to work. So now I have added the test.adoc to content/participate folder and updated index.html.haml to link it with this new page.

    The only problem is I forgot to clone from my own remote repo i.e. https://github.com/urwa/jenkins.io.git. Instead I cloned from the original repo i.e. https://github.com/jenkins-infra/jenkins.io.git

    So now I have local repo with a new branch and changes committed to it. BUT I am not sure which remote repo should I push the changes to.

    I would really appreciate any help.

    Mark Waite
    @MarkEWaite
    @urwa I can help with that.
    urwa
    @urwa
    Please do let me know.
    Mark Waite
    @MarkEWaite
    @urwa one technique is to add your personal repository as an additional remote using the commands:
    $ git remote add new-origin https://github.com/urwwa/jenkins.io.git
$ git remote rename origin upstream
$ git remote rename new-origin origin
$ git push --set-upstream origin YOUR_BRANCH_NAME_HERE