Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Activity
    Sachin Mukherjee
    @sachinmukherjee
    I'm new to opensource and want to contribute to the Jenkins project. Please suggest me some beginner-friendly project to start with. I have knowledge of Java, Python, and basics of Golang.
    Marky Jackson
    @markyjackson-taulia
    @sachinmukherjee A hearty welcome, so good to have you. Do start here: https://jenkins.io/blog/2019/10/01/hacktoberfest/
    If you have any question just ping us back here
    Sachin Mukherjee
    @sachinmukherjee

    So I have picked https://issues.jenkins-ci.org/browse/WEBSITE-663 as my first issue. After reading the issue discription what is understand is that

    Please correct me if i misunderstood something.

    Marky Jackson
    @markyjackson-taulia
    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
    @xxyy
    @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