* fix(flex): respect DesktopOnly and MobileOnly components
* Use classNames util function
* fix(ofm): allow wikilink alias to be empty (#1984)
This is in line with Obsidian's behavior.
* fix(style): Katex adding scrollbars on non-overflowing content (#1989)
* feat(i18n): Bahasa Indonesia translations (#1981)
* fix(a11y): increased content-meta text contrast (#1980)
* fix(analytics): streamline posthog script loading and event capturing (#1974)
* css: adjust color blend for search bg
* feat(links): added ofm option to style unresolved or broken links differently (#1992)
* feat: add option to disable broken wikilinks
* fix(style): update hover color for broken links and introduce new class
* feat: add "disableBrokenWikilinks" option to ObsidianFlavoredMarkdown
* chore(deps): replace `chalk` and `rimraf` with builtin functions (#1879)
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* chore(deps): bump the production-dependencies group across 1 directory with 9 updates (#1996)
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
* Node 22 (#1997)
* docs: showcase housekeeping
* docs: fix explorernode references (closes#1985)
* fix: tz-less date parse in local tz instead of utc (closes#1615)
* docs: added note to not forget to add https:// to the plausible-host (for #1337) (#2000)
* docs: added note to not forget to add https:// to the plausible-host (for #1337)
* Update docs/configuration.md
---------
Co-authored-by: Jacky Zhao <j.zhao2k19@gmail.com>
* Updated documentation
---------
Co-authored-by: Nizav <106657905+Ni-zav@users.noreply.github.com>
Co-authored-by: Aswanth <aswanth366@gmail.com>
Co-authored-by: Jacky Zhao <j.zhao2k19@gmail.com>
Co-authored-by: Keisuke ANDO <g.kei0429@gmail.com>
Co-authored-by: fl0werpowers <47599466+fl0werpowers@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Sebastian Moser <64004956+c2vi@users.noreply.github.com>
* docs: added note to not forget to add https:// to the plausible-host (for #1337)
* Update docs/configuration.md
---------
Co-authored-by: Jacky Zhao <j.zhao2k19@gmail.com>
* feat: add option to disable broken wikilinks
* fix(style): update hover color for broken links and introduce new class
* feat: add "disableBrokenWikilinks" option to ObsidianFlavoredMarkdown
* doc(favicon): add documentation of favicon plugin
* doc(favicon): add missing link to configuration page
* fix(favicon): build on public folder don't created
* fix(popover): automatically position heading links at heading
* Impement linking of blockreferences
* Popover fixes
* id mapping
* Remove excess regexes
* Updated blockref
* Remove linker element
* Restore the docs to their former glory
* Move the hash out of the loop
* Redundant
* Redundant
* Restore docs
* Remove log
* Let it const
* Fix(RecentNotes): Prevent folder pages from always appearing first
Pass prioritizeFolders=false to byDateAndAlphabetical in RecentNotes to sort strictly by date/alphabetical order, fixing issue #1901.
* refactor: split sorting functions for clarity
- Split byDateAndAlphabetical into two separate functions\n- byDateAndAlphabetical: sorts strictly by date and alphabetically\n- byDateAndAlphabeticalFolderFirst: sorts with folders first\n- Updated RecentNotes to use date-only sorting
* Fix(PageList): keep byDateAndAlphabeticalFolderFirst as the default sorting order for PageList
* fix(ogImage): update socialImage path to include base URL if defined
* feat(path): add function to check if a file path is absolute
* fix(ogImage): handle absolute paths for user defined og image paths
* docs(CustomOgImages): update socialImage property to accept full URLs
* fix(ogImage): typo
* fix(ogImage): improve user-defined OG image path handling
* Update docs/plugins/CustomOgImages.md
Co-authored-by: Jacky Zhao <j.zhao2k19@gmail.com>
* Update quartz/plugins/emitters/ogImage.tsx
Co-authored-by: Jacky Zhao <j.zhao2k19@gmail.com>
* refactor(path): remove isAbsoluteFilePath function
* fix(ogImage): update user-defined OG image path handling to support relative URLs
* feat(ogImage): enhance user-defined OG image path handling with absolute URL support
* refactor(ogImage): remove debug log for ogImagePath
* feat(path): add isAbsoluteURL function and corresponding tests
* refactor(path): remove unused URL import for isomorphic compatibility
---------
Co-authored-by: Karim H <karimh96@hotmail.com>
Co-authored-by: Jacky Zhao <j.zhao2k19@gmail.com>
* fix(transformer): find last modified date form commit on submodule
when the content folder has a submodule git, the relative path start in content folder and not root folder of quartz
* fix(transformer): use path.relative for improved path handling in last modified date calculation
* fix(transformer): keep find file from relative path of repo workdir
* fix(transformer): use variable for repository workdir
use default value if repo.workdir is undefined to user fullFp value
* fix(explorer): vertically center the Explorer toggle under mobile view
* Added a separate title font configuration
* Added googleSubFontHref function
* Applied --titleFont to PageTitle
* Made googleFontHref return array of URLs
* Dealing with empty and undefined title
* Minor update
* Dealing with empty and undefined title
* Refined font inclusion logic
* Adopted the googleFontHref + googleFontSubsetHref method
* Adaptively include font subset for PageTitle
* Restored default config
* Minor changes on configuration docs
* Formatted source code
* checkpoint
* make emitters async generators
* fix
* custom font spec
* replace spinner, use disk cache for fonts
* use readline instead
* make og images look nice
* start work on client side explorer
* fix tests
* fmt
* generic test flag
* add prenav hook
* add highlight class
* make flex more consistent, remove transition
* open folders that are prefixes of current path
* make mobile look nice
* more style fixes
* Added to the documentation which values of frontmatter are referenced.
* The source code I was looking at seemed to be out of date and the wrong listings were corrected.
* The list of frontmatter was moved to Frontmatter.md and a link was added.
On the surface it seems that only google and plausible scripts handle
the SPA correctly - but I don't know if maybe others handle
window.history API themselves somehow or something like that.
However, I am trying out goatcounter and in it's docs I see that it
does no special SPA handling, so this has to be fixed.
Just doing the dynamic script thing on every nav seems to do the trick.
The script is not "spa-preserve" so they wouldn't accumulate - and when
I tried the "spa-preserve" + call goatcounter api route it didn't quite
work, they actually did accumulate
With markdownLinkResolution: "shortest", aka "+/- how Obsidian does it"
and given pages A and nested/B which has an alias Z, if you try to link
from A using [[Z]] it wouldn't work and get 404.
This is caused by alias slugs (nested/Z in this case, emitted by
AliasRedirects) not being present in the `allSlugs` list which is used
by the link transformer.
The fix is to compute the alias slugs in the frontmatter transformer
and add them to `allSlugs` there.
Also we store them in file data to avoid recomputing them when emitting
alias redirect pages.
Fixes#904
Note: given how currently the markdown/html transformers are ordered
this doesn't really work.
Given pages A and nested/B which has an alias Z, here's the order which
currently happens:
md-transformers(A) => html-transformers(A) =>
md-transformers(B) => html-transformers(B)
Since the nested/Z slug will get added when md-transformers(B) are run,
but the slugs are used by html-transformers(A) when resolving it's
links - the link [[Z]] in A will still 404
A fix for this is to split the parser into two stages - first apply the
md-transformers to all files, and only then apply html-transformers to
all files.
I did just that in a different commit, which is needed for this one to
work correctly.
A final breadcrumb has an empty href, linking to the current page, but
the relative url normalization method missed those, making the link
appear broken in search previews and popovers.
Fixes#1690
If there is no `npm.exe` on the system, but
instead an `npm.cmd`, then node won't find
the `npm` executable when calling `spawnSync`.
This occurs frequently when using node package
managers on Windows.
See the node documentation for `.bat` and `.cmd`
files here.
<https://nodejs.org/api/child_process.html#spawning-bat-and-cmd-files-on-windows>.
* [OFM] Allow for dashes in custom callout label
For compatibility with Obsidian's behavior, a custom callout like
[!see-also] is possible. Previously, this was parsed by Quartz as a
callout “see” with metadata “-also”. Instead, this is should be a
callout “see-also” with title “See also” (capitalization + replace
dashes by spaces).
* prettier
* feat: add a config option for a pageTitleSuffix
* Run Prettier on Head.tsx
* Make pageTitleSuffix optional
Co-authored-by: Aaron Pham <Aaronpham0103@gmail.com>
---------
Co-authored-by: Aaron Pham <Aaronpham0103@gmail.com>
* Responsive design grid
* Addressed PR feedback
* Bump Quartz version 4.3.1 => 4.4.0
* Moved page-header into center
* Updated docs with new layouts
* Sync updated version number with package-lock
* Table of Content scrollbar auto
* Reset node_modules
* Updated layout images
* Fixed tablet layout
* Finilazed layout images
* FIX: Reload graph after a theme change
* FIX: Reload graph after a theme change - comment updated
* FIX: Reload graph after a theme change - comment updated
* FIX: Reload graph after a theme change
* fix: Reload graph after a theme change
* Use a `<button>` for theme toggle
* docs: Adds back Xinyang's cs garden to showcase (#1323)
adding back my garden which was deleted from the cleanup showcase
* feat(toc,explorer): add accessibility for toggle (#1327)
* Restore focus highlight on explorer toggle button.
Remove `unset: all` declaration causing `outline`
property to be unset. This allows the default
browser focus highlight to be shown.
* Fix semantics of expandable sections (explorer, toc).
This adds the appropriate aria attributes for the [disclosure pattern](https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/examples/disclosure-image-description/#javascriptandcsssourcecode) and uses `visibility: hidden` to remove the hidden elements from the focus order without disrupting the animations. Further work is needed on the tree view nodes.
* Run prettier for SCSS files.
* feat: custom global latex macros (closes#1325)
* chore: ts fixes
* docs: recommend at least node 20 in gh
* fix: unmemoize explorer on rebuild (closes#1077)
* fix: pass buildId to worker
* Fix theme button DOM hierarchy and styles
* Restore functionality of theme button
* `aria-label` on theme svgs so their accessible labels are included in button content
---------
Co-authored-by: Xinyang Yu <47915643+xy-241@users.noreply.github.com>
Co-authored-by: Jacky Zhao <j.zhao2k19@gmail.com>
* Add a wrapper span to dates in PageList.
This means there is a placeholder when date is not specified, so the values in grid-template-columns always line up correctly.
* Use a <div> instead -- better practice to stick to block elements.
* Use a `<button>` for search
* Fix search button styles to match preexisting styling
* Remove additional native button properties.
* Invoke search button on click or keyboard.
* Reorganize search button DOM hierarchy
* Restore focus to the search button when exiting the search overlay
* Run prettier on Search.tsx
* Restore focus highlight on explorer toggle button.
Remove `unset: all` declaration causing `outline`
property to be unset. This allows the default
browser focus highlight to be shown.
* Fix semantics of expandable sections (explorer, toc).
This adds the appropriate aria attributes for the [disclosure pattern](https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/examples/disclosure-image-description/#javascriptandcsssourcecode) and uses `visibility: hidden` to remove the hidden elements from the focus order without disrupting the animations. Further work is needed on the tree view nodes.
* Run prettier for SCSS files.
- [Major] Changed `hash` passed to `querySelector` to `decodeURIComponent(hash)` to fix the issue where non-English anchors were not correctly positioning the popover content to the corresponding title.
- [Minor] Updated the type hint from `HTMLLinkElement` to `HTMLAnchorElement` as the passed element is an `<a>` element, not a `<link>` element (reference: https://developer.mozilla.org/en-US/docs/Web/API/HTMLLinkElement).
* replace .gitlab-ci.yml example with more reliable and faster ci job
* literally removing 1 space, inside a code block, in docs, just to make prettier not cry
simplifies slug from FullSlug to SimpleSlug before storing it in the visited pages list in memory
this leads to "index" page and "folder/index", "tags/tag/index" being stored a "/", "folder/" and "tags/tag/" respectively in the list of visited pages.
this ensures that the homepage is rightfully coloured as a visited page in the "color" function of the graph
3f325ff Added all N3 notions
06af741 Obsidian settings updated
b399f6b Added a new style for other side usage
git-subtree-dir: content
git-subtree-split: 3f325ffe0f3ee8169ee45746916e823422ab0591
* Tags appear as hollow circles on the graph
Added a few lines to make tags appear as hollow circles on the graph, as opposed to pages which are plain circles, for better visual separation.
* Applied Prettier code style
* fix: change callout metadata regex to include non-letter characters
* fix: make metadata regex non-greedy
This allows for users to have callouts such as
> [!NOTE|left foo-bar 123] a ]+ title with square brackets [s] a
> Contents
* Add homepage link with internationalization
* Construct pathname from baseUrl config value
* More robust URL manipulation
* Add Farsi (#1133)
* Fix bad rebase
2024-05-22 16:44:54 -04:00
303 changed files with 21483 additions and 18766 deletions
Means "if", "whenever". Used when a result is known or assumed to be true, aka a logical cause-effect relationship. Cannot be used if the result is uncertain. So it cannot be an intention, a request, a desire, an order, etc.
> [!info] Example
> {急|いそ}いでない==と==、{遅刻|ちこく}に{着|つ}きます。
> If you don't hurry, you'll arrive late.
## なら
<divclass="usage">
<divclass="left">
<p><spanclass="box">V (casual) + (の)</span></p>
<p><spanclass="box">い-Adj + (の)</span></p>
<p><spanclass="box">な-Adj + (の)</span></p>
<p><spanclass="box">N</span></p>
</div>
<pclass="right">+ なら</p>
</div>
Means "in the case that/of". The second part of the sentence is generally an opinion, a request or a suggestion.
Adding の adds emphasis. ならば can be used in more formal contexts.
Means "if" or "when". Describes a condition (the first action must be completed before the second action). Used for hypothetical situations and certain results. It is the main word used for conditional.
> [!info] Example
> {安|やす}==かったら==、{買|か}う。
> (If / When) it's cheap, I'll buy it.
## 場合
<divclass="usage">
<divclass="left">
<p><spanclass="box">V (casual)</span></p>
<p><spanclass="box">い-Adj</span></p>
<p><spanclass="box">な-Adj + な</span></p>
<p><spanclass="box">N + の</span></p>
</div>
<pclass="right">+ 場合は</p>
</div>
{場合|ば|あい} means "in the case of". The second part explains what to do in the situation (instructions, advices, etc). More formal than たら.
> [!info] Example
> {地震|じ|しん}==の場合は==、エレベーターを使わないでください。
> In case of an earthquake, please don't use the elevators.
@ -8,16 +8,16 @@ The goal of this website is to be a synthesis of useful resources for my Japanes
## Sources
Of course, since I'm _learning_ the language, I need to borrow what I write from different sources. So this website uses data from the websites listed here. I don't want any recognition of what is here! It's mostly a compilation of what people who are way better in this language have made before.
Of course, since I'm _learning_ the language, I need to get inspired from different sources. So this website partly uses information from the websites listed here. I don't want any recognition of what is here! It's mostly a compilation of what people who are way better in this language have made before.
@ -45,8 +46,12 @@ In addition to those I cited, here are other resources I find useful.
### Vocabulary
* [Jisho](https://jisho.org/), an online dictionary
* [Tangorin](https://tangorin.com/sentences), for its sentences database
* [Tatoeba](https://tatoeba.org), for its sentences database
### Apps
- [Anki](https://apps.ankiweb.net/), the spaced repetition software
## Any errors?
If you find any error, please do contact me! You can find my website in the footer of any page of this website. Thanks!
If you find any error, please do contact me! I wrote the examples by myself, so they might not be accurate. You can find my website in the footer of any page of this website. Thanks!
> No matter how much I train, I cannot run a marathon.
### どうしても
Means "no matter what".
> [!info] Example
> ==どうしても=={花火|はなび}に行きたい。
> No matter what, I want to go see the fireworks.
## At least
### 少なくとも
{少|すく}なくとも means "at least". Implies an obligation.
> [!info] Example
> ==少なくとも==もっと{三人|さんにん}が{必要|ひつよう}です。
> At least three more people are required.
### せめて
Means "at least". Implies a request.
> [!info] Example
> ==せめて=={週|しゅう}に{一度|いちど}{勉強|べんきょう}してください。
> Please study at least once a week.
## だけましだ
<divclass="usage">
<divclass="left">
<p><spanclass="box">V</span></p>
<p><spanclass="box">い-Adj</span></p>
<p><spanclass="box">な-Adj + な</span></p>
<p><spanclass="box">N + である</span></p>
</div>
<pclass="right">+ だけましだ</p>
</div>
Means "should be grateful for", "at least", "better than". Means that while something is not good, or not as good as one wishes, it's still better than nothing or an alternative.
> [!info] Examples
> {給料|きゅうりょう}がちょっとすくない、{就職|しゅうしょく}==だけましだ==。
> The salary is a little low, but at least I found a job.
に{相|そう}{違|い}ない means "certain that". It is very formal.
> [!info] Example
> 彼女は{必|かなら}ず{悲|かな}しい==に相違ない==。
> I'm certain that she's sad.
## Uncertain: というものではない
Means "there is no guarantee that", "not necessarily".
> [!info] Example
> {高|}い{商品|しょうひん}を{買|か}って{良質|りょうしつ}==というものではない==。
> Buying a product that is expensive does not guarantee that it is of good quality.
## Not always: とは限らない
<divclass="usage">
<divclass="left">
<p><spanclass="box">V</span></p>
<p><spanclass="box">い-Adj</span></p>
<p><spanclass="box">な-Adj + だ</span></p>
<p><spanclass="box">N + だ</span></p>
</div>
<pclass="right">+ とは限らない</p>
</div>
とは{限|かぎ}らない means "not always", "not necessarily".
> [!info] Example
> {大人|おとな}は{正|ただ}しい==とは限らない==。
> Adults are not always right.
## Impossible
### わけがない
<divclass="usage">
<divclass="left">
<p><spanclass="box">V</span></p>
<p><spanclass="box">い-Adj</span></p>
<p><spanclass="box">な-Adj + な</span></p>
</div>
<pclass="right">+ わけがない</p>
</div>
Means that there is no way, "impossible". The nuance is that the way of doing is unknown, thus impossible for the subject. But someone else might know.
It can also mean that the will to do is not present, especially with する.
> [!info] Example
> もうこんな時間。帰り==わけがない==。
> It's already this late. I have no way to go back home (I don't know how).
### ようがない・ようもない
~{様|よう}がない means that there is no way, "impossible".
Works by removing ~ます from a verb and adding ようがない・ようもない.
The nuance it that it is impossible in general. With する, it can mean the same as わけがない, i.e. "I don't know how to".
> [!info] Example
> {全部|ぜんぶ}食べられる==ようがない==よ!
> It is impossible to eat it all!
### まさか
Usually at the start of a sentence, expresses surprise, about something that seemed impossible.
@ -9,7 +9,9 @@ Those rules combine a verb and an adjective to make a new meaning.
<pclass="r">+ Adj</p>
</div>
## ~やすい
## Difficulty
### ~やすい: easy
Means:
* easy to do
@ -23,7 +25,7 @@ Means:
> {泣|な}き==やすい==。
> Prone to crying.
## ~にくい・~づらい
### ~にくい・~づらい: difficult
Means that something is difficult to do.
While にくい is the broader form, づらい is used in a more subjective manner, for actions that are intentional.
@ -32,6 +34,15 @@ While にくい is the broader form, づらい is used in a more subjective mann
> 見==にくい==。
> Difficult to see.
### ~がたい: very difficult
~がたい means that something is very difficult to do.
It is more extreme than ~にくい.
> [!info] Example
> それは{信|しん}じ==がたい==な。
> That's hard to believe...
## ~始める
~{始|はじ}める means that something starts or has started. Expresses intentionality.
@ -63,3 +74,137 @@ While にくい is the broader form, づらい is used in a more subjective mann
> [!info] Example
> {飲|の}み==終わります==。
> To stop to drink.
## ~上げる
This can be used both as:
* {上|あ}げる means "finish doing" (transitive)
* {上|あ}がる means "was finished" (intransitive)
> [!info] Example
> {全部|ぜんぶ}の{夏休|なつ|や}みの{宿題|しゅくだい}を出来==上げった==。
> I have finished all my summer homework.
## ~合う
~{合|あ}う means that the action is done with someone else.
> [!info] Example
> {妹|いもうと}と{家|いえ}へ{帰|かえ}り==会った==。
> I went home with my sister.
## ~切る・~切れる・~切れない
~{切|き}る means "to do completely" and ~切れる means "able to do completely".
The negative form ~切れない means "unable to do", "too much to complete".
It focuses on the end of the action rather than the process.
> [!info] Example
> 父はすべての{部屋|へや}を{掃除|そうじ}し==切った==。
> My father finished cleaning all the rooms.
>
> 彼は{納豆|なっとう}を食べ==切れなかった==。
> He could not finish all his natto.
## ~通す
~{通|とお}す means "to do something until the end", "continually" or "through". It focuses on the process of the action, rather than its ending.
> [!info] Example
> マラソンの{全部|ぜんぶ}を{走|はし}り==通した==。
> He ran through the whole marathon.
## ~直す
~{直|なお}す means to do something again.
> [!info] Example
> {今年|ことし}をやり==直す==てほしい。
> I want this year to start over.
## ~っぱなし
~っぱなし means leaving something as it is.
> [!info] Example
> この13時間{飛行|ひこう}で{座|すわ}り==っぱなし==でした。
> I sat the entire time on this 13 hours flight.
## ~かねる
~かねる means "unable to do", due to an external circumstance. It is polite.
> [!info] Example
> ごめんなさい、それをでき==かねます==。
> I'm sorry, I cannot do that.
## ~っこない
~っこない means that something is not possible.
> [!info] Example
> {全然|ぜんぜん}{勉強|べんきょう}しなかった。。。{合格|ごうかく}し==っこない==よ。
> I did not study at all... There's no way I'll pass.
## ~抜く
~{抜|ぬ}く means to do something to the end, or completely. The nuance is that someone tried hard and has made an effort to achieve this result.
> [!info] Example
> それは{毎日|まいにち}やり==抜く=={無理|むり}ですよ。
> You cannot do this every day.
## ~給え
~{給|たま}え is used for a light order. It is used by someone of higher rank to someone of lower rank.
> [!info] Example
> ここに{座|すわ}り==給え==。
> Seat here.
## ~つつ(も)
~つつ means that something happens at the same time as another action. Adding も adds the meaning of "even": "even while doing".
> [!info] Example
> 食べ==つつ==、飲みましょう。
> While eating, let's drink.
## ~つつある
~つつある means that something is in an ongoing process or action, in a similar manner as てくる.
> [!info] Example
> {雪|ゆき}が{降|ふ}り==つつある==。
> It is snowing.
## ~込む
~{込|こ}む has multiple meanings depending on the verb. Sometimes it is idiomatic and so it cannot exactly be guessed. However, there are some broad categories.
⚠ Depending on the context, verbs can fall into multiple categories!
### Going into
* If the verb describes a movement, adding 込む add the meaning of "into" (jumping => jumping into).
* If the verb already has a notion of "into", it put emphasis into it. It could have a meaning like "completely into".
> [!info] Example
> {海|うみ}に{飛|とび}び==込んだ==。
> He jumped into the ocean.
### Emphasis
When the verb does not include physical movement, 込む can be used to put emphasis on certain verbs (deeply, a lot, etc).
> [!info] Example
> {猫|ねこ}が{眠|ねむ}り==込んでいます==。
> The cat is fast asleep.
### Repetition
The last common meaning is for an action that is repeated until a point is reached. It can also be an action that is done for a long time.
> [!info] Example
> {毎朝|まいあさ}5キロ{走|かし}り==込む==。
> Every morning I go for a 5km run (emphasis on the fact that it is a long run).
Means "if" when a result is known or assumed to be true, aka a logical cause-effect relationship. Cannot be used if the result is uncertain. So it cannot be an intention, a request, a desire, an order, etc.
> [!info] Example
> {急|いそ}いでない==と==、{遅刻|ちこく}に{着|つ}きます。
> If you don't hurry, you'll arrive late.
## なら
<divclass="usage">
<divclass="left">
<p><spanclass="box">V (casual) + (の)</span></p>
<p><spanclass="box">い-Adj + (の)</span></p>
<p><spanclass="box">な-Adj + (の)</span></p>
<p><spanclass="box">N</span></p>
</div>
<pclass="right">+ なら</p>
</div>
Means "in the case that/of". The second part of the sentence is generally an opinion, a request or a suggestion.
Means "if" or "when". Describes a condition (the first action must be completed before the second action). Usually used for hypothetical situations. It is the main word used for conditional.
> [!info] Example
> 安==かったら==、買う。
> (If / When) it's cheap, I'll buy it.
## 場合
<divclass="usage">
<divclass="left">
<p><spanclass="box">V (casual)</span></p>
<p><spanclass="box">い-Adj</span></p>
<p><spanclass="box">な-Adj + な</span></p>
<p><spanclass="box">N + の</span></p>
</div>
<pclass="right">+ 場合は</p>
</div>
{場合|ば|あい} means "in the case of". The second part explains what to do in the situation (instructions, advices, etc). More formal than たら.
> [!info] Example
> {地震|じ|しん}==の場合は==、エレベーターを使わないでください。
> In case of an earthquake, please don't use the elevators.
Means "as", "in the role of". The と particle implies a result.
Used with nouns.
> [!info] Example
> 彼はカメラマン==としては==いい{仕事|しごと}をする。
> As a cameraman, he does a good job.
## にしては
Means "considering", "for". The に particle implies a simultaneous existence.
The difference with としては resides in the fact that this is used to make a contrast between the general image associated with something and what we're describing.
Used with verbs and nouns.
> [!info] Example
> このカバンは安い==にしては==悪くない。
> This bag might be cheap, it is not bad.
## としても
Means "assuming", "even if". It has the same meaning as [[TeF (4) - even if#Even if ても・でも]], but bolder.
> [!info] Example
> 私==としても==出来ます。
> I can do it as well.
## にしても
Means "even if", "even though". It has the same meaning as [[🔰 Particles (1)#も]], but bolder. In some rare written cases, it has the same meaning as としても.
> I brush my teeth twice a day as recommended by my dentist.
### に伴って
に{伴|ともな}って also has the meaning of a an instantaneous change: when the first part changes, the second part also changes instantly. The first part is the reason of it changing.
> As the Olympics are held, transportations cost have increased.
### と共に
と{共|とも}に has 3 other meanings.
#### Almost at the same time
It is also used for two actions that happens at approximately the same time. The two actions do not have to be related. They also don't have to be specifically about change.
> [!info] Example
> {鳥|とり}は{鳴|な}き{声|ごえ}をする==と共に=={風|かぜ}が{吹|ふ}く。
> The bird sings and the wind blows.
#### Together with
It can also mean "together with". It is much more formal than {一緒|いっしょ}に.
> [!info] Example
> {妻|つま}==と共に=={新|あたら}しい{人生|じんせい}を{始|はじ}めります。
> I am starting a new life with my wife.
#### As well as, also
It can also mean "as well as", "also".
> [!info] Example
> パンはチーズ==と共に==フランスに{人気|にんき}{食料|しょくりょう}です。
> Bread, along with cheese, is a popular food in France.
Means that something doesn't change state, stays as it is.
> [!info] Examples
> {開|あ}けた==まま==。
> To be left open.
>
> {熱|あつ}い==まま==。
> Still hot.
>
> {昔|むかし}の==まま==。
> As it always been.
>
> その==まま==でいい。
> It is fine as it is.
> Soccer is his strong point. You could almost say he's a pro.
## がする
@ -85,35 +67,39 @@ Used with a verb in dictionary form.
> {絵|え}を{塗|ぬる}る==のが下手==です。
> I'm not good at painting.
## くらい・ぐらい
## だらけ
Means that something is "full of" or "covered with" something undesirable.
> [!info] Example
> {子供|こども}のズボンは{泥|どろ}==だらけ==です。
> The child's pants are covered in mud.
## を込めて
を{込|こ}めて means that something is "full of" or "filled with". Used with positive feelings.
> [!info] Example
> この{映画|えいが}は{監督|かんとく}から{愛|あい}==を込めて=={作|つく}った。
> That movie was made with love from the director.
## は~で有名
<divclass="usage">
<pclass="iright">N + は + </p>
<divclass="ileft">
<divclass="left">
<p><spanclass="box">V (ない)</span></p>
<p><spanclass="box">い-Adj</span></p>
<p><spanclass="box">な-Adj + な</span></p>
<p><spanclass="box">N + の</span></p>
<p><spanclass="box">V + こと</span></p>
<p><spanclass="box">い-Adj + こと</span></p>
<p><spanclass="box">な-Adj + な + こと</span></p>
<p><spanclass="box">N</span></p>
</div>
<pclass="right">+ くらい・ぐらい</p>
</div>
<pclass="right">+ で有名</p>
</div>
Means "about" or "approximately" when talking about numbers or counter words. ぐらい is more common in conversations, but can change depending on the preceding word.
は~で{有名|ゆうめい} means "famous for". Used to describe why people, places or things are famous.
> [!info] Example
> {電車|でんしゃ}はどの==くらい==で{到着|とうちゃく}しますか。
> About how much time will the train take to arrive?
>
> {医者|いしゃ}に1時間==ぐらい==を{待|ま}ってました。
> I waited approximately an hour for the doctor.
Also used to compare things as being similar.
> [!info] Example
> {友達|ともだち}と{試験|しけん}の{結果|けっか}は{同|おな}じ==ぐらい==です。
> My friend and I have about the same results at the test.
Also means "to the extent of".
> [!info] Example
> 食べなくて{寝|ね}たい==ぐらい=={疲|つか}れています。
> I'm tired to the extent of not eating and going to sleep.
> My mother can speak Portuguese as well as Spanish.
## おまけに
Means "in addition". Used for emphasis for similar qualities (positive, negative). Used orally.
> [!info] Examples
> {暑|あつ}くて==おまけに==エアコンが{壊|こわ}れてしまった。
> It was hot, and to make matters worse, the air conditioning broke.
## しかも
Means "moreover", "what's more". Talks about a same subject, for objective information, implying that A and B exist at the same time. It is similar to おまけに, but used for writing.
> [!info] Examples
> このレストランはとても{美味|おい}しいね。==しかも==、{安|やす}いよ!
> This restaurant is delicious. What's more, it's cheap!
## 上に
<divclass="usage">
<divclass="left">
<p><spanclass="box">V</span></p>
<p><spanclass="box">い-Adj</span></p>
<p><spanclass="box">な-Adj + な</span></p>
<p><spanclass="box">N + の</span></p>
</div>
<pclass="right">+ 上(に)</p>
</div>
{上|うえ}に means "and also", "in addition", "as well". Used with similar qualities (positive with positive, negative with negative).
> [!info] Examples
> この{家|いえ}は{狭|せま}い==上に=={家賃|やちん}は{高|たか}すぎる。
> This house is small, and the rent is too expensive.
## その上
その{上|うえ} means "besides", "in addition". Means the same as 上に, but with two separate sentences.
> [!info] Examples
> この{家|いえ}は{狭|せま}い。==その上==、{家賃|やちん}は{高|たか}すぎる。
> This house is small. In addition, the rent is too expensive.
## に加えて
に{加|くわ}えて means "in addition to". It is formal, and often used in business settings.
Used with nouns.
> [!info] Examples
> {今年|ことし}はピンポン==に加えて==バドミントンを{教|おし}えます。
> This year, I'll be teaching badminton in addition to ping pong.
## Not only, but also
### はもちろん
<divclass="usage">
<divclass="">
<p><spanclass="box">N</span></p>
</div>
<pclass="r">+ はもちろん + </p>
<divclass="">
<p><spanclass="box">phrase</span></p>
</div>
<pclass="r">+ も・さえ</p>
</div>
Means "not only but also", "not to mention". The most common form.
> [!info] Examples
> このゲームセンターにはゲーム==はもちろん==ボウリング==も==あります。
> This game center not only has games but also bowling.
### はもとより
Means "not only but also". Similar meaning than はもちろん. Conveys a sense of continuity. Used mostly in writing.
Used with nouns.
> [!info] Examples
> {雪|ゆき}が{多|おお}いので、{電車|でんしゃ}==はもとより==タクシーもない。
> There is so much snow that there are no trains, let alone taxis.
> Please bring a pencil and an eraser to the exam.
### て connecting
Used for a list that is exhaustive. Connects verbs.
@ -57,7 +66,7 @@ See [[TeF (1) - basics#て sequence]].
### や
Used for a list that is unexhaustive. Translates to "among other things". Formal.
Used only with nouns. Cannot be repeated!
Used only with nouns.
> [!info] Example
> フランス==や==スペインに{旅行|りょこう}しました。
@ -66,16 +75,25 @@ Used only with nouns. Cannot be repeated!
### など
Means "things as". Can be used with や for a meaning like "etc".
Used with nouns. Cannot be repeated!
Used with nouns.
> [!info] Example
> お金がないのでカフェ**や**レストラン==など=={払|はら}えない。
> I can't pay things like cafes or restaurant (etc.) because I have no money.
### といった
Used to describe typical examples: "things as", "like", "such as". It is casual. It has the same meaning as など.
Used with nouns.
> [!info] Examples
> フランスとカナダ==といった=={国|くに}はフランス{語|ご}を{話|はな}す。
> Countries such as France and Canada speak French.
### とか~とか
Used for a list that is unexhaustive. Translates to "among other things". More casual than や or たり~たり. Ending a sentence with とか can soften the meaning. Can also be used to quote someone.
Only used with verbs and nouns. Can be repeated.
Used for a list that is unexhaustive. Translates to "and", "among other things". More casual than や. Ending a sentence with とか can soften the meaning. Can also be used to quote someone.
Only used with verbs and nouns.
> [!info] Examples
> {果物|くだもの}はバナナ==とか==リンゴ==とか==が好きです。
@ -94,13 +112,12 @@ Only used with verbs and nouns. Can be repeated.
This is used to list things that are related, in an unexhaustive way. Translates to "do things such as".
Usually used to talk about things like hobbies, explaining liked things, activities done, etc.
This is used to list things that are related, in an unexhaustive way. Translates to "or", "do things such as".
Usually used to talk about things like hobbies, explaining liked things, activities done, etc. Not used for usual things like a routine. It is not an ordered or chronological list like [[#て connecting]].
が{必要|ひつよう} is used mainly with nouns (can be used with verbs by appending こと before).
{必要|ひつよう}がある is used with verbs.
> [!info] Example
> {今時|いまどき}、{携帯電話|けいたいでんわ}==が必要です==。
> Nowadays, a cell phone is necessary.
>
> 今日はパン{屋|や}に行く==必要がない==。
> No need to go to the bakery today.
# Obligation: なければ・ないと
## Must
@ -52,18 +39,6 @@ In casual contexts, can be shortened as ないと.
> 今日は{勉強|べんきょう}し==ないといけない==。
> I have to study today.
### Comparing いけない and ならない
* ==いけない== is the standardly used form. It implies a subjective view, that it would be better to do something, to avoid negative consequences (eg: brushing one's teeth, eating well, etc).
* ==ならない== is usually more formal or in written form. It implies a is more objective view, something that has to be done because there's no other way (eg: respecting the law, paying taxes, etc).
### Comparing なくては, なければ and ないと
なくては and なければ are generally interchangeable in speech. However:
* ==なくては== is generally used when there is _no penalty_ for not complying.
* ==なければ== is generally used when there _is a penalty_ for not complying.
* ==ないと== is lighter and does not imply that there can or cannot be penalty. Its construction is based on the [[Conditional#と]] particle, and should be based on knowledge or experience.
## Must not
#### 「ちゃ・じゃ」「だめ・いけない・いけません」
@ -83,16 +58,20 @@ This form is used with a V-て, depending on the ending:
### てはいけない
Used in a more formal or written manner. Used with a V-て.
てはならない is a stronger form.
> [!info] Example
> {鉄道|てつ|どう}に{歩|ある}い==てはいけません==。
> Do not walk on the railroad.
### なくてもいい
## Comparing いけない and ならない
Means "don't have to". Used with a verb in the negative form (ない), appending なくてもいい.
Can also be used as なくていい.
* ==いけない== is the standardly used form. It implies a subjective view, that it would be better to do something, to avoid negative consequences (eg: brushing one's teeth, eating well, etc).
* ==ならない== is usually more formal or in written form. It implies a is more objective view, something that has to be done because there's no other way (eg: respecting the law, paying taxes, etc).
> [!info] Example
> 今日はレストランで{手伝|て|つ}わ==なくてもいい==。
> You don't have to help out at the restaurant today (it's okay if you don't help at the restaurant today).
## Comparing なくては, なければ and ないと
なくては and なければ are generally interchangeable in speech. However:
* ==なくては== is generally used when there is _no penalty_ for not complying.
* ==なければ== is generally used when there _is a penalty_ for not complying.
* ==ないと== is lighter and does not imply that there can or cannot be penalty. Its construction is based on the [[Conditional#と]] particle, and should be based on knowledge or experience.
> There's no way I don't go to my younger brother's birthday today, so I won't go to the afterwork.
>
> {本当|ほんとう}に飲み会に行く==わけにはいかない==よ。
> There's really no way I can go to the afterwork.
## なくてもいい
Means "don't have to". Used with a verb in the negative form (ない), appending なくてもいい.
Can also be used as なくていい.
> [!info] Example
> 今日はレストランで{手伝|て|つ}わ==なくてもいい==。
> You don't have to help out at the restaurant today (it's okay if you don't help at the restaurant today).
## てからでないと
Means "must first do". The second part becomes possible after the first one.
Used with a verb in て form, with からでないと or からでないければ.
> [!info] Example
> {払|はら}==ってからでないと=={入|はい}るができること。
> You can enter only after paying.
## こと as "should do"
### こと
<divclass="usage">
<divclass="left">
<p><spanclass="box">V (dictionary)</span></p>
<p><spanclass="box">V (ない)</span></p>
</div>
<pclass="right">+ こと</p>
</div>
Means "should do". Mostly used to set rules.
> [!info] Example
> ここに{車|くるま}を{止|と}めない==こと==です。
> Don't park your car here.
### ことになっている
This form is used to express rules or expectations.
Used with dictionary (る) and negative (ない) form of verbs.
> [!info] Examples
> {指|ゆび}で食べない==ことになっている==。
> You're not supposed to eat with your fingers.
### ことはない
This has two meanings:
* it is not necessary to
* it never happens
Used with a verb in the dictionary form.
> [!info] Example
> {走|はし}る==ことはない==。まだ{時間|じかん}がある。
> There's no need to run. There's still time.
## 必ず
{必|かなら}ず means certainly, definitely. Expresses an obligation.
> [!info] Example
> 明日の{授業|じゅ|ぎょう}==必ず==来てください。
> Please be sure to attend tomorrow's class.
## べき
### べきだ
Means "should do", "must do". Compared to the [[Obligation - なければ・ないと]] forms and 必ず, it has a nuance of being less universally logical. It is defined by the speaker's own logic.
Used with verbs.
する can be used as するべき or すべき.
> [!info] Example
> {来週|らいしゅう}{試験|しけん}があるので{勉強|べんきょう}す==べきです==。
> There is an exam next week, so I should study.
### べきではない・べきじゃない
The contrary of べきだ is べきではない・べきじゃない.
> [!info] Example
> {泥|どろ}を食べる==べきではない==。
> You should not eat mud.
## はずだ・はずがない
<divclass="usage">
<divclass="left">
<p><spanclass="box">V</span></p>
<p><spanclass="box">い-Adj</span></p>
<p><spanclass="box">な-Adj + な</span></p>
<p><spanclass="box">N + の</span></p>
</div>
<pclass="right">+ はずだ ・ はずがない</p>
</div>
はずだ means "it must/should be", while はずがない means "it cannot be". Has a nuance of being sure that it is something possible (or impossible).
This has the meaning of like, easy to, _-ish_. Makes a direct comparison with certainty, from the point of view of the person saying it. Close to an even more casual meaning of みたい.
> [!info] Examples
> {子供|こ|ども}==っぽい==。
> Childish.
>
> {忘|わす}れ==っぽい==。
> Easy to forget.
### らしい
Expresses an information based on hearsay, or based on the situation, or ressemblance. This is always used bases on a source that is unknown or ambiguous. It can be similar to a guess.
Also used for something typical.
> [!info] Examples
> 男==らしい==。
> Typical of a man (befitting of a man).
>
> 今日は{君|きみ}==らしくない==。
> You aren't yourself today.
### そう
#### そうだ
<divclass="usage">
<divclass="left">
<p><spanclass="box">V (casual)</span></p>
<p><spanclass="box">い-Adj</span></p>
<p><spanclass="box">な-Adj + だ</span></p>
<p><spanclass="box">N + だ</span></p>
</div>
<pclass="right">+ そうだ</p>
</div>
Means "I heard that".
### そうだ
<divclass="usage">
<divclass="left">
@ -179,15 +63,13 @@ Means "I heard that".
</div>
Means that it looks like.
Do not confuse with [[Observation - hearsay#そうだ]].
> [!info] Examples
> テストは{難|むず}しい==だそうだ==。
> The exam is said to be difficult.
>
> [!info] Examples
> おいし==そうだ==。
> lt looks like it is delicious.
#### そうに・そうな
### そうに・そうな
<divclass="usage">
<divclass="left">
@ -204,15 +86,107 @@ Also means that it looks like, but connecting to nouns and verbs.
> 面白==そうに==人です。
> He seems like an interesting person.
### Summing it up
## みたい
🛠 To do: check validity.
みたい means similar to, like. Used for direct observation, with a high degree of certainty in consequence. Usually used for visual observation.
It is a less polite form of ようだ.
* ==ようだ== is a formal way to say that it looks like, usually from direct observation.
* ==みたい== is a less formal way, used in a casual conversation.
* ==っぽい== is even more casual. A girl trying to be masculine would be 男っぽい.
* ==らしい== is usually used when something is typical or expected. The same girl wouldn't be either 女らしい or 男っぽい because it's not what is expected from her.
* ==そうだ== is used for something that is hearsay or not directly observation, more as a guess.
### みたいだ
The basic form, used with all forms of words.
> [!info] Example
> 今日は暑いですね。夏==みたいだ==な。
> It's hot today, isn't it. It looks like it's summer.
### みたいに
<divclass="usage">
<divclass="left">
<p><spanclass="box">V (casual)</span></p>
<p><spanclass="box">N</span></p>
</div>
<pclass="right">+ みたいに + V / Adj</p>
</div>
The adverbial form.
> [!info] Example
> 犬==みたいに==食べた。
> I ate like a dog.
### みたいな
<divclass="usage">
<divclass="left">
<p><spanclass="box">V (casual)</span></p>
<p><spanclass="box">N</span></p>
</div>
<pclass="right">+ みたいな + N</p>
</div>
Similar to the precedent form, but when using with nouns.
> [!info] Example
> {故郷|ふる|さと}==みたいな==町だ。
> A city like my hometown.
## らしい
Expresses an information based on hearsay, or based on the situation, or ressemblance. This is always used based on a source that is unknown or ambiguous. It can be similar to a guess. Similar to the "perhaps" meaning of ようだ.
Also used for something typical, expected, characteristic.
This has the meaning of like, easy to, _-ish_. Makes a direct comparison with certainty, from the point of view of the person saying it. Close to an even more casual meaning of みたい, with a focus on attitude or gesture.
Means "even if", "even though". It has the same meaning as [[#て-form even if]].
> [!info] Example
> {今|いま}で行==ったって==、{間|ま}に{合|あ}わない。
> Even if you go now, you won't make it in time.
## それでも
Means "but still", "even so", "anyway".
> [!info] Example
> 雨が{降|ふ}っていた、==それでも==出かけていた。
> It was raining, but I still went out.
## のに
Means "although", "even tough". Cannot be an hypothesis, must be a confirmed fact. This, it works with past tense.
See [[Connectors#のに#Even tough]].
## くせに・くせして
<divclass="usage">
<divclass="left">
<p><spanclass="box">V</span></p>
<p><spanclass="box">い-Adj</span></p>
<p><spanclass="box">な-Adj + な</span></p>
<p><spanclass="box">N + の</span></p>
</div>
<pclass="right">+ くせに・くせして</p>
</div>
Means "despite", "even tough". Has a negative connotation when a situation is not what was expected. Regularly used to talk about characteristics. Like のに, cannot be an hypothesis.
くせして is more familiar than くせに.
> [!info] Example
> {掃除|そうじ}すると言った==くせに==、まだ{汚|きたな}いよ。
> You said you would clean it up, but it's still dirty.
>
> {子供|こども}の==くせに==、{数学|すうがく}が{得意|とくい}です。
> Despite a child, he is good at math.
## ながらも
Means "even while", "despite". It is used to express that while something is one state, something else. Cannot be used for an hypothesis: it is something that is happening right now.
See also [[Time - during#ながら]].
> [!info] Example
> {病気|びょうき}==ながらも==、パーティーに行くつもりです。
> Although I am sick, I'm planning to go to party.
## Summing up
* ==ても==, ==「と・に」しても==, ==たって== and ==それでも== have the same meaning.
* ==「と・に」しても== have a bolder meaning.
* ==それでも== breaks up the phrase.
* ==のに== cannot be used for conditional situations.
* ==くせに== talks about disappointment or characteristics.
* ==ながらも== talks about something happening right now.
It is a polite request that is translated as "please do". See Conjugation [[Basics]] ("command").
It is a polite request that is translated as "please do".
In casual speech, can be shortened to て.
> [!info] Example
@ -27,6 +27,8 @@ Means "is it alright if?", "may I?".
> ここに{座|すわ}==てもいい==ですか。
> May I sit here?
A more polite way is [[Can't help - doesn't matter#ても構わない]].
## ないでください
Means "please don't". It is a polite request. Removing the ください makes it more casual.
@ -47,8 +49,17 @@ It is used with verbs by removing the ます and adding なさい. In casual con
## ように言う
<divclass="usage">
<pclass="r">V +</p>
<divclass="">
<p><spanclass="box">ように</span></p>
</div>
<pclass="r">+ V 「言う・命じる・頼む・...」</p>
</div>
It means "to tell", "to request", "to order".
It is form by added ように{言|い}う to a verb. The verb {頼|たの}む can be used for requests, while {命|めい}じる can be used for order. The verb {言|い}う can tell the three meanings depending on the tone.
The verb {頼|たの}む can be used for requests, while {命|めい}じる can be used for order. The verb {言|い}う can tell the three meanings depending on the tone. Other similar verbs can be used ({注意|ちゅうい}する, {進|すす}む, etc).
Means "as long as", "if only". If a certain condition is met, the result will be okay.
> [!info] Examples
> {公園|こうえん}==さえ==あれ==ば==、うれしいです。
> As long as there is a park, I am happy.
## かける
Means "half", "not yet finished", "in the middle of".
Made by removing the ます stem of a verb.
> [!info] Examples
> この{本棚|ほんだな}はまだ{作|つく}り==かける==です。
> This bookshelf is not yet finished building.
## 一方だ
{一方|いっぽう}だ means "to continue to", "more and more".
Used with verbs that expresses change.
> [!info] Examples
> {禁煙|きんえん}の{場所|ばしょ}は{増|ふ}えている==一方です==。
> The number of places where smoking is prohibited keeps increasing.
## ばかりだ
Means "to continue to", in a negative direction. Used with verbs in the dictionary form (る), that describe a form of change. Can also be used as ばっかり, ばっか, ばかし, and ばっかし instead of ばかり.
Means "while", "simultaneously". The difference with ついでに is that here the main action is the second one. Happens at the same time.
> [!info] Example
> {歩|ある}き==ながら=={電話|でん|わ}を見ています。
> While walking, I'm looking at my phone.
## ついでに
<divclass="usage">
<divclass="left">
<p><spanclass="box">V (dictionary)</span></p>
<p><spanclass="box">V (た)</span></p>
<p><spanclass="box">N + の</span></p>
</div>
<pclass="right">+ ついでに</p>
</div>
Means "while", "at the same time". The difference with ながら is that here the main action is the first one. An opportunity of doing something during the occurrence of the first one (but not for the entire time).
> [!info] Example
> スーパーに行く==ついでに==、おにぎりを{買|か}ってくれませんか。
> While you're going to the supermarket, could you bring onigiri?
## と同時に
<divclass="usage">
<divclass="left">
<p><spanclass="box">V (る)</span></p>
<p><spanclass="box">い-Adj</span></p>
<p><spanclass="box">な-Adj + である</span></p>
<p><spanclass="box">N</span></p>
</div>
<pclass="right">+ と同時に</p>
</div>
と{同時|どうじ}に means "at the same time as", "while". Contrary to ながら, it is used for something that happens at a precise moment, not during the whole time.
> [!info] Example
> {電車|でんしゃ}に{乗|の}っている==と同時に==、おじいさんが{落|お}ちた。
> While on the train, an old man fell off.
## 中
{中|ちゅう}・{中|じゅう} means different things depending on its pronunciation:
* ちゅう is used when pointing a specific time: "during", "at some point".
* じゅう is used for the entire time or area: "through", "within", "before it ends".
> [!info] Example
> {午後|ごご}==中==に{会議|かいぎ}がある。
> There is a meeting in the afternoon (ちゅう).
>
> {今年|ことし}==中==にスウェーデンに行きたい。
> I want to go to Sweden before the end of this year (じゅう).
## うちに
<divclass="usage">
<divclass="left">
<p><spanclass="box">V (casual)</span></p>
<p><spanclass="box">い-Adj</span></p>
<p><spanclass="box">な-Adj + な</span></p>
<p><spanclass="box">N + の</span></p>
</div>
<pclass="right">+ うちに</p>
</div>
Means "while". The nuance is that the time is optimal and should be taken advantage of.
> [!info] Example
> {晴|は}れる==うちに=={散歩|さんぽ}しましょう。
> Let's take a walk while the weather is nice.
## 限り
<divclass="usage">
<divclass="left">
<p><spanclass="box">V (る・た・ない・ている・)</span></p>
<p><spanclass="box">N + である</span></p>
</div>
<pclass="right">+ 限り</p>
</div>
{限|かぎ}り means "as long as", "while". Also means "limited to".
Means that something happened recently, either just now, or a little while ago.
> [!info] Example
> ==さっき==家に出てきた。
> I just left home.
## たところ
Combined with a verb in the past tense, it express that something just occurred (something just ended, just started, etc).
> [!info] Example
> 今食べた==ところ==だ。
> I just finished to eat right now.
## たばかり
Combined with a verb in the past tense, it express that something just occurred (something just ended, just started, etc). It is more subjective than ところ. It doesn't have to be something that literally just happened, but something that feels like it just happened.
> [!info] Example
> 今食べた==ばかり==だ。
> I just finished to eat right now.
When comparing the two examples, the meaning is different depending on the context. Imagine a friend asking you to go eat with him. When using ところ, it means you just finished your meal this instant. When using ばかり, it means that it feels too soon to eat again just yet from your point of view, independently of how much time has really passed.
Means that something has just been finished. It cannot be used with all verbs. It has a meaning of something fresh, that changes after completion (fresh food that degrades, etc).
A first meaning is similar to {間|あいだ} (while), but with intentionality.
> [!info] Example
> 電車に{乗|の}った==間に==、本を読みました。
> While I was on the train, I read a book.
A second meaning is a statement of something that happened during a time period, independently of your actions.
Contrary to 間, it doesn't include the whole time period. So 間に means that at a point during the time period, something happened.
> [!info] Example
> {夜|よる}の==間に==、{隣|となり}の木が{落|お}ちていた。
> During the night, the tree next door fell.
# から~まで
See から: [[🔰 Particles (2)#From, since]].
See まで: [[🔰 Particles (2)#まで]].
See から~まで: [[🔰 Particles (2)#から~まで]].
See から: [[🔰 Particles (2)#From, since]] (from).
See まで: [[🔰 Particles (2)#まで]] (until).
See から~まで: [[🔰 Particles (2)#から~まで]] (from... until).
## 前に
@ -140,75 +86,13 @@ See から~まで: [[🔰 Particles (2)#から~まで]].
> 食べた==後で==、寝ます。
> After eating, I'll go to sleep.
## さっき
Means that something happened recently, either just now, or a little while ago.
> [!info] Example
> ==さっき==家に出てきた。
> I just left home.
## たところ
Combined with a verb in the past tense, it express that something just occurred (something just ended, just started, etc).
> [!info] Example
> 今食べた==ところ==だ。
> I just finished to eat right now.
## ているところ
See [[TeF (2) - manner of doing#ているところ]].
## たばかり
Combined with a verb in the past tense, it express that something just occurred (something just ended, just started, etc). It is more subjective than ところ. It doesn't have to be something that literally just happened, but something that feels like it just happened.
> [!info] Example
> 今食べた==ばかり==だ。
> I just finished to eat right now.
When comparing the two examples, the meaning is different depending on the context. Imagine a friend asking you to go eat with him. When using ところ, it means you just finished your meal this instant. When using ばかり, it means that it feels too soon to eat again just yet from your point of view, independently of how much time has really passed.
## 急に
{急|きゅう}に means that something happened unexpectedly or quickly.
> [!info] Example
> ==急に==電車が{現|あらわ}れた。
> A train suddenly appeared.
## やっと
Means that something happened at last. More rarely means "barely".
> [!info] Example
> ==やっと=={論文|ろん|ぶん}を書き{終|お}わった。
> I finally finished writing my thesis.
## までに
This indicates a time limit for the action, similar to "by".
> [!info] Example
> {来週|らい|しゅう}==までに=={終|お}わってください。
> Please finish by next week.
## おきに
This is used for repeated intervals, after a noun indicating something measurable.
> [!info] Example
> この電車は4分==おきに=={出発|しゅ|っぱつ}します。
> This train leaves every four minutes.
## ころ・ごろ
<divclass="usage">
<divclass="left">
<divclass="">
<p><spanclass="box">N (time)</span></p>
</div>
<pclass="right">+ ごろ</p>
<pclass="r">+ ごろ</p>
</div>
Means "around" or "about".
@ -229,5 +113,129 @@ Means "around" or "about".
Means "when".
> [!info] Example
> 子供の==ころ==、毎日{公園|こうえん}で{遊|あそ}んだ。
> {子供|こども}の==ころ==、毎日{公園|こうえん}で{遊|あそ}んだ。
> When I was a kid, I played every day at the park.
## までに
This indicates a time limit for the action, similar to "by".
> [!info] Example
> {来週|らい|しゅう}==までに=={終|お}わってください。
> Please finish by next week.
## ぶりに
<divclass="usage">
<divclass="">
<p><spanclass="box">N (time)</span></p>
</div>
<pclass="r">+ ぶりに~する</p>
</div>
<divclass="usage">
<divclass="">
<p><spanclass="box">N (time)</span></p>
</div>
<pclass="r">+ ぶり + の</p>
<divclass="">
<p><spanclass="box">N</span></p>
</div>
</div>
Means "for the first time in duration". Used for long times (can be a psychologically perceived one).
Used with nouns measuring time.
> [!info] Example
> 3{年|ねん}==ぶりに==ブラジルを{戻|もど}ります。
> For the first time in 3 years, I'm returning to Brazil.
## に先立ち
<divclass="usage">
<divclass="left">
<p><spanclass="box">V (る)</span></p>
<p><spanclass="box">N</span></p>
</div>
<pclass="right">+ に先立ち・に先立って</p>
</div>
に{先|さき}{立|だ}ち means "before", "prior to". It is formal.
Also used as に先立つ when a second noun follows a first one.
> [!info] Examples
> {初|はじ}める==に先立って==、{準備|じゅんび}しないといけない。
> Before starting, you need to prepare.
## 上で
<divclass="usage">
<divclass="left">
<p><spanclass="box">V (た)</span></p>
<p><spanclass="box">N + の</span></p>
</div>
<pclass="right">+ 上で</p>
</div>
{上|うえ}で means "after", "upon". Shows a logical progression. Mostly used in formal situations.
> [!info] Examples
> {面接|めんせつ}の==上で==、{連絡|れんらく}します。
> We will contact you after the interview.
## にあたって
<divclass="usage">
<divclass="left">
<p><spanclass="box">V (る)</span></p>
<p><spanclass="box">N</span></p>
</div>
<pclass="right">+ にあたって</p>
</div>
Means "at the time of", "on the occasion of". It is formal. Used when talking about the preparation.
This allows to transform an adjective into a noun (adjective nominalizer). Similar to さ, but it is used in specific contexts. Rather than a degree, it talks about a quality. Generally subjective. Can be used with less adjectives than さ.
> [!info] Example
> 甘い。
> Sweet.
>
> 甘さ。
> Amount of sweetness.
>
> 甘==味==。
> Quality of sweetness.
## ということ: phrase as noun
This allows to transform a phrase into a noun.
@ -68,7 +90,7 @@ Also means "the reason for A is B", "doing A is B".
> このレストランで{一番|いち|ばん}{人気|にん|き}がある==のは=={寿司|すし}です。
> The most popular dish in the restaurant is sushi.
## くする: い-adjectives as adverbs
## くする: い-adjective as adverb
Replacing the い in a い-Adj by くする transforms it into an adverb.
大きい (big) => 大きくする (make big).
@ -77,7 +99,7 @@ Replacing the い in a い-Adj by くする transforms it into an adverb.
> エアコンを{点|つ}けると{空気|くう|き}が{寒|さむ}==くなる==。
> When turning on the AC, the air becomes cold.
## にする: な-adjectives as adverbs
## にする: な-adjective as adverb
Appending にする to a な-Adj transforms it into an adverb.
{静|しず}かな (quiet) => 静かにする (make quiet).
@ -86,6 +108,22 @@ Appending にする to a な-Adj transforms it into an adverb.
> {部屋|へや}をきれい==にして==ください。
> Please clean the room (make the room cleaner).
## がる・がっている: adjectives as verbs
## がる・がっている: adjective as verb
See [[Observation - Description#がる・がっている]].
See [[Observation - tendency - feelings#がる・がっている]].
@ -25,10 +25,11 @@ The following sections will go into detail for what methods can be implemented f
-`BuildCtx` is defined in `quartz/ctx.ts`. It consists of
-`argv`: The command line arguments passed to the Quartz [[build]] command
-`cfg`: The full Quartz [[configuration]]
-`allSlugs`: a list of all the valid content slugs (see [[paths]] for more information on what a `ServerSlug` is)
-`allSlugs`: a list of all the valid content slugs (see [[paths]] for more information on what a slug is)
-`StaticResources` is defined in `quartz/resources.tsx`. It consists of
-`css`: a list of URLs for stylesheets that should be loaded
-`css`: a list of CSS style definitions that should be loaded. A CSS style is described with the `CSSResource` type which is also defined in `quartz/resources.tsx`. It accepts either a source URL or the inline content of the stylesheet.
-`js`: a list of scripts that should be loaded. A script is described with the `JSResource` type which is also defined in `quartz/resources.tsx`. It allows you to define a load time (either before or after the DOM has been loaded), whether it should be a module, and either the source URL or the inline content of the script.
-`additionalHead`: a list of JSX elements or functions that return JSX elements to be added to the `<head>` tag of the page. Functions receive the page's data as an argument and can conditionally render elements.
## Transformers
@ -37,7 +38,7 @@ Transformers **map** over content, taking a Markdown file and outputting modifie
An emitter plugin must define a `name` field, an `emit` function, and a `getQuartzComponents` function. `emit` is responsible for looking at all the parsed and filtered content and then appropriately creating files and returning a list of paths to files the plugin created.
An emitter plugin must define a `name` field, an `emit` function, and a `getQuartzComponents` function. It can optionally implement a `partialEmit` function for incremental builds.
- `emit` is responsible for looking at all the parsed and filtered content and then appropriately creating files and returning a list of paths to files the plugin created.
- `partialEmit` is an optional function that enables incremental builds. It receives information about which files have changed (`changeEvents`) and can selectively rebuild only the necessary files. This is useful for optimizing build times in development mode. If `partialEmit` is undefined, it will default to the `emit` function.
- `getQuartzComponents` declares which Quartz components the emitter uses to construct its pages.
Creating new files can be done via regular Node [fs module](https://nodejs.org/api/fs.html) (i.e. `fs.cp` or `fs.writeFile`) or via the `write` function in `quartz/plugins/emitters/helpers.ts` if you are creating files that contain text. `write` has the following signature:
@ -234,7 +249,7 @@ export type WriteOptions = (data: {
// the build context
ctx: BuildCtx
// the name of the file to emit (not including the file extension)
@ -48,4 +48,4 @@ Here are the main types of slugs with a rough description of each type of path:
-`SimpleSlug`: cannot be relative and shouldn't have `/index` as an ending or a file extension. It _can_ however have a trailing slash to indicate a folder path.
-`RelativeURL`: must start with `.` or `..` to indicate it's a relative URL. Shouldn't have `/index` as an ending or a file extension but can contain a trailing slash.
To get a clearer picture of how these relate to each other, take a look at the path tests in `quartz/path.test.ts`.
To get a clearer picture of how these relate to each other, take a look at the path tests in `quartz/util/path.test.ts`.
@ -29,11 +29,14 @@ Some common frontmatter fields that are natively supported by Quartz:
- `title`: Title of the page. If it isn't provided, Quartz will use the name of the file as the title.
- `description`: Description of the page used for link previews.
- `permalink`: A custom URL for the page that will remain constant even if the path to the file changes.
- `aliases`: Other names for this note. This is a list of strings.
- `tags`: Tags for this note.
- `draft`: Whether to publish the page or not. This is one way to make [[private pages|pages private]] in Quartz.
- `date`: A string representing the day the note was published. Normally uses `YYYY-MM-DD` format.
See [[Frontmatter]] for a complete list of frontmatter.
## Syncing your Content
When your Quartz is at a point you're happy with, you can save your changes to GitHub.
Some files were not shown because too many files have changed in this diff
Show More
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.