sscharter 0.7.0 → 0.9.0

data/tutorial/tutorial.md

@@ -107,7 +107,7 @@ big-d
 ├── README.md
 ├── src
 │   └── master.rb
-└── .sscharter.yml
+└── sscharter.yml
 ```
 
 Here are some explanation for each of them.
@@ -121,13 +121,13 @@ see [the official documentation](https://bundler.io/man/gemfile.5.html).
 If you do not use Git as the version manager for your project, it does nothing.
 - `Rakefile` contains some tasks that can be run by [Rake](https://ruby.github.io/rake/).
 - `README.md` is the README file of your project.
-- `.sscharter.yml` is the sscharter configuration for your project.
+- `sscharter.yml` is the sscharter configuration for your project.
 - `files` is the directory whose files will be included in the final level file.
-You can change the directory in `.sscharter.yml`.
+You can change the directory in `sscharter.yml`.
 - `src` is the directory that contains the source codes of your project.
-You can change the directory in `.sscharter.yml`.
+You can change the directory in `sscharter.yml`.
 
-Open `.sscharter.yml` using your text editor.
+Open `sscharter.yml` using your text editor.
 Here are the contents that you should see:
 
 ```yaml
@@ -332,7 +332,7 @@ Then, edit `Rakefile` to disable browser launching and enable live restart:
 
 ```ruby
 task :serve do
-  exec 'bundle exec sscharter serve --no-open-browser --live-restart'
+  exec 'bundle exec sscharter serve --no-open-browser'
 end
 ```
 
@@ -952,6 +952,56 @@ end
 # write something here...
 ```
 
+Sometimes even `preserve_beat: false` is not convenient enough to write complicated note patterns.
+The `mark` and `at` methods can help you with more complicated charts.
+
+Use `mark` to mark a place and label it with a symbol of your choice
+(e.g. `:left_hand`), and use `at` to write notes at that point.
+
+```ruby
+group, preserve_beat: false do
+  # write something here...
+  mark :left_hand # mark the current place with the label `:left_hand`
+end
+
+group do
+  # write something here...
+  mark :right_hand # mark the current place with the label `:right_hand`
+end
+
+at :left_hand do
+  # write notes here as if continuing where `mark :left_hand` is
+end
+
+at :right_hand do
+  # write notes here as if continuing where `mark :right_hand` is
+end
+```
+
+You can also use `at` with `update_mark: true` to update the mark
+to the place where the block in `at` is ended.
+
+```ruby
+group do
+  # ...
+  mark :x
+  # ...
+end
+
+at :x, update_mark: true do
+  # ...
+end
+
+at :x do
+  # as if continuing the last `at :x, update_mark: true` block
+end
+```
+
+Usually, when `at` finishes, the current beat is set
+to whatever it was before `at` was called.
+You can keep the current beat by using `preserve_beat: true`
+in the call of `at`.
+
 ### BPM changes
 
 > [!NOTE]
@@ -1191,6 +1241,21 @@ transform duplicate notes, new_tip_points: false do
 end
 ```
 
+When you use `mark` inside a tip point block,
+the tip point state is also preserved when you use `at` later.
+For example:
+
+```ruby
+tp_chain 0, 100, 1 do
+  t 0, 0; b 1
+  mark :my_mark
+end
+
+at :my_mark do
+  t 100, 0 # this note will be connected by the same tip point
+end
+```
+
 ## Advanced charting techniques
 
 TODO.

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: sscharter
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Ulysses Zhan
-autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-09-09 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rubyzip
@@ -16,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.3'
+        version: '3.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.3'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: launchy
   requirement: !ruby/object:Gem::Requirement
@@ -94,6 +93,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -122,7 +135,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
-description: 
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
 email:
 - ulysseszhan@gmail.com
 executables:
@@ -148,7 +174,7 @@ licenses: []
 metadata:
   homepage_uri: https://github.com/sunniesnow/sscharter
   source_code_uri: https://github.com/sunniesnow/sscharter
-post_install_message: 
+  changelog_uri: https://github.com/sunniesnow/sscharter/releases
 rdoc_options: []
 require_paths:
 - lib
@@ -163,8 +189,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
 summary: A Ruby DSL for writing Sunniesnow charts
 test_files: []