Comments (7)
Once again, this is much more complicated than I expected. I was planning to use the Carpentries Lesson template as the basis for the changes. However, that lesson uses "The Carpentries style version 9.5.3." whereas AOS says "Using The Carpentries theme". These seem to have very different structures.
from python-aos-lesson.
Thanks for spotting this, @eldobbins.
@fmichonneau - What is the relationship between the following two sites?
https://github.com/carpentries/styles
https://github.com/carpentries/carpentries-theme
Do we need to update this repo (perhaps by starting all over following the instructions at https://carpentries.github.io/lesson-example/ ?) in order to get the benefit of updates and improvements to the carpentries lesson style?
from python-aos-lesson.
Hello both,
Yes, lessons in the Carpentries Incubator, the CarpentriesLab, and some of the more recent official lessons use the remote theme feature from GitHub.
For these repositories, to preview the lessons locally, you need:
- ruby
- bundler
We have had a pull request open for a while that provides instructions for installing those. It hasn't been merged because of a lack of testing on Windows (and in general, we'd welcome more feedback on the instructions).
So, depending on your setup, you might be able to run:
make serve
as all the other lessons and get the lesson rendered locally. If not, use the installation instructions included in the pull request to install ruby and bundler.
Please feel free to reach out here if there are any questions I might be able to answer. Thanks!
from python-aos-lesson.
@fmichonneau Thank you for your reply. I read the PR and carpentries/maintainer-RFCs#1. But I'm still a little confused.
Is https://carpentries.github.io/lesson-example/index.html the best example of how to set-up a lesson currently? I do not see a reference to remote themes in that lesson. Is there a different template for a lesson with remote themes?
Are remote themes definitely the way lessons will be organized in the future? Is there a method for migrating lessons from an older format to the new one? I'm concerned that we might put time into migrating to a new format that will be out-of-date in a little while.
Or is this lesson, perhaps, already up-to-date because it is in CarpentriesLab? Then I just need to use the newer rendering solution.
from python-aos-lesson.
Are remote themes definitely the way lessons will be organized in the future?
Yes, we are currently still in a testing phase to understand pain points for lesson contributors and maintainers.
Because we are in a testing phase and some details may change, we are working on the documentation aspect. Typically, I have worked closely with people who have been using our remote themes so I apologize for the frustration of trying to figure things on your own with no documentation.
Other aspects that need improvement are:
- re-organization of the styles repository to continue to provide updates for files that are not included in the remote theme
- documentation on how to transition to using the remote theme
- modifications of the scripts that check the formatting of the lessons (the
lesson_check.py
script for instance). Help with this would be greatly appreciated!
In this testing phase, I'm happy to provide the support needed to ensure that your lesson will be functional and will use this information to shape the documentation. If you are working in a different repository and need help to get set up, please let me know. My email is [email protected].
from python-aos-lesson.
I ended up using Anaconda to install Jekyll et al. I'm on a Mac, and thought originally I could use the default ruby install. But that turned out to be for system stuff and required constantly sudoing. I tried compiling Jekyll myself, but couldn't get eventmachine to compile. Luckily, there is a version of Jekyll on condo-forge.
I'm submitting a PR that includes the YAML file for the conda environment, and the bare-bones additions needed for make lesson-check
to at least get started. It isn't running all the way through, but I think that will be a series of future PRs to fix.
from python-aos-lesson.
https://github.com/carpentrieslab/python-aos-lesson/pull/30
from python-aos-lesson.
Related Issues (20)
- Update 06-github HOT 1
- Finish large data lesson HOT 1
- Add metadata to images HOT 5
- JupyterLab
- Reconsider asserts HOT 5
- Pangeo Binder as a backup
- Use shorter file names?
- Add example of zoomed in lat/lon in addition to the global plot
- Add a map_blocks example
- Add content on Dask task graph and debugging HOT 1
- Create a synthetic large dataset?
- Other options for parallel processing
- New EOS book on Earth Observation Using Python: A Practical Programming Guide HOT 2
- Dead link in the Large Data section HOT 1
- xarray.compute() should return an xarray instance
- conda-forge channel needs full path or can't be added HOT 3
- Expand the vectorisation lesson to "xarray thinking" HOT 1
- Helper script references non-existent data file
- Capturing small changes HOT 2
- Transition to new lesson infrastructure?
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from python-aos-lesson.