Skip to content

Website for FOLIO open source development dev.folio.org

Notifications You must be signed in to change notification settings

folio-org/folio-org.github.io

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

This is the source for "FOLIO Developers" at dev.folio.org

To contribute changes, please refer to FAQs regarding Developer documentation.

Software requirements

Local development requires Ruby and Bundler. The 'bundle install' step will install the relevant local Jekyll.

For Ruby, using rbenv and its 'ruby-build' plugin ensures a smooth process. In this directory, set the ruby version with: rbenv local 3.2.5

Then do:

bundle config set --local path 'vendor/bundle'
bundle install

Occasionally a site maintainer will have updated dependencies, and there will be changes to the Gemfile.lock file. Do bundle install again.

Docker

Instead of installing the requirements you may run

docker-compose up

to use the Jekyll Docker image.

Our Gemfile defines the version of Jekyll that we use.

Local development

To view and edit documents on your local machine, run the local Jekyll server:

bundle exec jekyll serve --port 5000

Then visit localhost:5000 with the browser, and proceed to the page of interest.

Edit the relevant Markdown source document, and save it. The server will automatically re-generate that particular page. Now refresh the web browser to view its changes.

When finally ready with your set of changes, commit and push the branch to GitHub. See deployment notes below.

Link checker

To verify internal and external links, do:

rake proof

or

bin/htmlproofer.sh

This will re-generate the whole site, then report any broken links.

Note that verification of GitHub links is disabled.

Work area - management of dev site

See notes about the operation and management. (Despite the name of this repository, it is not built using the GitHub tools.)

Deployment

The master branch is automatically deployed as dev.folio.org

Other branches are re-built upon push of changes. Follow the GitHub link from the branch's continuous-integration details to view the generated branch site.

NOTE: Since May 2023 the AWS Codebuild system has denied building of new branches via the GitHub UI. A new branch can still be created, and used locally, and used for the pull-request. But the ability to view an AWS build of the branch via GitHub is now gone.

Additional information

Refer to FAQs regarding Developer documentation and Raising Jira tickets.

The FOLIO Slack channel #dev-website